Markdown、HTML、PDF 与 DOCX：每一步该用哪种格式

Markdown 描述结构：标题、列表、强调、链接和代码。它几乎不谈字体、页边距或分页。这正是它适合起草和版本管理的原因。如果文档需要精确间距或固定表格宽度，Markdown 就不适合做终点。把它当源格式，写完再转到排版格式。

HTML 能表达的比 Markdown 多：带 colspan 的表格、行内样式、嵌入媒体和语义标签。Markdown 转 HTML 通常单向无损。HTML 转回 Markdown 则有损。优先把 Markdown 当真相源，HTML 当派生视图。

PDF 记录完成的视觉结果。因此适合合同和发票，也因此是糟糕的中间格式。如果还要改，保留 Markdown、HTML 或 DOCX 源，最后再导出 PDF。

DOCX 带有样式、批注、修订、页眉页脚和复杂表格。多数无法干净映射到 Markdown。目标是 Markdown 时，先在 Word 里接受修订、删除批注，并用命名样式。

Markdown 通常用相对路径引用图片。PDF 和 DOCX 嵌入图片字节。本地正常的 Markdown 如果路径解析失败，导出的 DOCX 会缺图。发送前务必打开导出文件检查每张图。

文字为主时用 Markdown 起草。网页预览转 HTML，协作转 DOCX，定稿再导出 PDF。避免把 PDF 转 Markdown 当主路径；只有 PDF 源时手工重建结构。

用不同软件打开结果。确认标题层级、列表嵌套、表格列、图片和特殊字符。百分之九十五正确的转换往往比大声失败更危险。

当设计把 Figma 当真相、工程把 Markdown 当真相、法务把 DOCX 当真相时，团队就会陷入麻烦。为正文选一个可编辑源，为交付格式选一条导出路径。转换于是变成机械步骤。没有该约定，每个截止日期都会长出一份无人能安全更新的手工 PDF。

（中文扩写）Markdown and HTML diff cleanly in git. DOCX and PDF do not. If multiple people edit the same document, keep the collaborative truth in a text format or in a system designed for simultaneous editing, and export DOCX or PDF as snapshots. Otherwise merge conflicts become binary nightmares and nobody can see who changed a sentence.

（中文扩写）Manual export from a desktop app drifts: different people use different settings. If Markdown is the source, generate HTML and PDF in a pipeline with pinned tool versions. The first setup costs time; the hundredth export then matches the first. Pinning also makes broken formatting bisectable when a dependency changes behaviour.

（中文扩写）A rendered preview shows the happy path. A textual diff shows accidental deletions, reordered sections and silent normalisation of quotes or spaces. For regulated or long-lived content, require a diff review when Markdown changes before PDF export. Previews catch layout; diffs catch content loss.