2026_DesignAI/.claude/skills/markdown-to-docx/references/editorial-template-rules.md

DOCX Template Rules

This file records Word-export rules that the template rendering pipeline tries to enforce.

Non-negotiable layout rules

• Prefer the latest reviewed .docx as the --reference-doc when available; treat a .dotx as a base template.
• If the reference template contains Word shortcut bindings, generated .docx files should retain word/customizations.xml so style hotkeys such as ALT+1 remain available. The render pipeline auto-copies these bindings when the reference template already contains them.
• Replace only the default header text. Keep first-page and even-page headers blank unless the editor file shows otherwise.
• Strip Pandoc body styles such as FirstParagraph, BodyText, and Compact so the reference template's body style wins.
• Keep screenshot/image paragraphs mapped to the custom style 图.
• Map figure captions to the custom style 图题.
• Apply Word keep with next to every 图 paragraph so each image stays on the same page as the following figure caption.
• Apply Word keep with next to every 表题1-1 paragraph so each table caption stays on the same page as the following table.
• Map only real note/warning labels such as 注：, 注意：, and 关键注意： to the custom style 注意.
• Keep generic explanatory lead-ins such as 说明： and 解释： in body text, or rewrite them into prose in the source manuscript.
• Remove the first-line indent from exported code-block paragraphs (Source Code / 代码清单) so code starts flush-left inside the code block.
• Clear first-line indent for all paragraphs inside Word table cells so table content does not visually inherit body-text indentation.
• Align unordered-list text with the Chinese body-text first-line indent. Avoid Word's default deep bullet indentation; level-0 bullet text should start at the same visual column as a normal Chinese paragraph first line.

Figure and table caption rules

• Figure captions must use the short form 图1-1 标题.
• Table captions must use the short form 表1-1 标题.
• Use hyphen serials such as 1-1, not dotted serials such as 1.1.
• Do not place explanatory text inside figure captions.
• If a source figure caption contains a second explanatory sentence, move that sentence into body text and keep only the short title in the caption.
• Figure and table captions should not end with a full stop.

Editorial writing rules reflected in export

• When the text says 确认, 确保, or 检查, provide an explicit verification action or acceptance signal nearby instead of leaving the confirmation vague.
• Prefer 如图1-1所示 style references in body text when explanation needs to point readers back to a screenshot.
• Treat structural rewrites separately from template rules. Examples: adding bridge sentences, converting numbered explanation lists into prose, or rewriting a subsection outline.