docs-doc-blog

What problem does it solve?

It helps you write retikz blog (MDX) articles that match the project’s required structure, style, and collaboration workflow, so readers get consistent, skimmable, cross-platform-friendly content.

Core Features & Use Cases

• Blog writing spec for retikz: Enforces audience/intent, sectioning rules (H2/H3 as short noun/verb phrases), and pacing/length constraints to avoid off-topic or overly long posts.
• MDX production rules: Requires short paragraphs (≤3 lines), promotes tables/lists/code blocks, and prioritizes <ComponentPreview> for demos while forbidding disallowed MDX elements (e.g., docs-only components).
• Cross-platform hand-carry constraints: Ensures content remains readable when retold on platforms that don’t support the same MDX components, including frontmatter stripping behavior and link/text fallback expectations.
• References & bilingual strategy: Adds a required ## 引用 / ## References section when links are present, and supports zh-first with optional en translation while preserving retikz/TikZ terminology.

Quick Start

Ask the AI to convert your section-by-section notes into index.zh.mdx that follows the retikz blog spec for a /blog/... post, then review the draft before proceeding to the next section.