场景解决方案2026年6月27日

用 Markdown 写文档,怎么交付成 Word 或 PDF?

客户和老师只收 Word 或 PDF,不能直接发 .md。本文对比粘贴、pandoc、浏览器转换三类方法,并讲清 Word 和 PDF 怎么选、表格代码目录哪里会翻车。

你用 Markdown 写得很顺,下游却只认 Word 或 PDF。问题不是 Markdown 不行,而是 .md 是源码,对方要的是排版成品。先选对交付格式,再选对转换路径,表格、代码、目录才不容易翻车。

文章核心论点配图

为什么不能直接把 Markdown 当 Word 发?

因为 .md 是源码,.docx 和 .pdf 是排版成品,两者不在同一层。## 标题 只是标记;对方电脑若没有渲染器,看到的就是带 # 的纯文本,没有字号、目录、页码。客户、导师、行政同事的工作流是 Office 和 PDF,发给他们 .md 等于交半成品。双击 .md 只看到井号,属于打开问题,见下载的 .md 怎么打开;本文只谈交付。

该交 Word 还是 PDF?

对方还要改稿或套模板就交 Word;只要定稿、打印、防止再改就交 PDF。两种格式解决的是不同下游,不是谁更高级。

对方要做什么 交什么 原因
批注、改措辞、套单位模板 Word(.docx) 样式可继续编辑
打印、归档、投稿只收 PDF PDF 版式锁死,换电脑也不重排
只要「看起来正式」 优先 PDF 少一次「你再另存一下」
双方都要改同一份 Word,或继续用 .md 协作 PDF 不适合来回改

同一份 .md 可以分别导出两种格式,正文不用写两遍。先定交哪一种,再选转换方法。

Markdown 转 Word / PDF 有哪几种方法?

主流有三类,按省事程度和可控程度排开:

方法 适合场景 常见坑
复制预览结果粘进 Word 一两段短内容 带网页样式,字号行距错位
命令行 pandoc 批量、自动化、自定义模板 要安装、记参数、处理中文字体
浏览器里转换 偶尔转单个文件、立刻要结果 超长文档受浏览器内存限制

要进 CI 每天批量出 PDF,pandoc 是正解;只是偶尔交一份作业或方案,装环境和调模板的成本通常高于在浏览器转一次。

用浏览器把 .md 转 Word 或 PDF 怎么做?

偶尔交付时,最省事的是浏览器转换:不装环境、不记参数。把 .md 拖进 Markdown 转换,选 Word 或 PDF,开始转换后下载即可。

转换质量取决于两件事:源码结构是否规范,以及引擎是否做结构化映射(标题变成 Word 标题样式,而不是「看起来像标题的大号字」)。Word 输出应是真正的 .docx,对方能在样式窗格里改标题;PDF 则应带分页、可用的中文字体和看得清的表格线。

转换前源码要先修哪些格式?

转换结果乱,经常是源 Markdown 本身不规范:# 后面漏空格、列表缩进忽大忽小、有序列表全写成 1.。预览器可能「碰巧」显示正常,换一个转换引擎就会错位。

正式交付前用文本编辑器扫一遍:

  • 标题:# 与文字之间有一个空格,且不要跳级(# 后面直接 ###);
  • 列表:同一层级缩进一致,用空格而不是混用 Tab;
  • 表格:分隔行 | --- | --- | 列数与表头一致;
  • 图片:本地图用相对路径,并保证图文件和 .md 在一起。

别人发来的乱稿,先修这四项再转,比转完在 Word 里手工收拾快。

表格、代码、目录、图片,哪里最容易翻车?

这四处是交付里最常见的差评来源,和「会不会转」无关,和「转的是结构还是画面」有关。

  • 表格:列数对、单元格里不要硬换行。宽表在 Word 里还能拖列宽;进 PDF 可能被裁切,超宽表宜先拆表或改成列表。
  • 代码块:要保留语言标记(如 ```python),转换后才有机会高亮。不要把代码当普通引用块,换行和缩进会丢。
  • 目录:Markdown 本身通常没有自动目录。需要 PDF 书签或 Word 目录时,应让转换器按标题层级生成,而不是手打一页「目录」再盼它对上页码。
  • 本地图片:转换时必须能读到文件。只写 ![](./fig.png) 却没把 fig.png 一起带走,导出里就会缺图。远程图片若对方服务器禁跨域,可能变成占位图,整份转换不一定失败。
  • 篇幅:80–150 页通常稳定;200 页以上按二级标题拆开分别导出再合并,避免一次占满内存。
  • 字体:中文 PDF 用转换器内置的宋体/黑体一类更稳。若交的是还要别人继续改的 Word,正文用宋体、微软雅黑、Arial,少用只有你电脑上才有的字体。

什么时候该用 pandoc,而不是浏览器?

要批量、自动化、强模板时用 pandoc:每天从一堆 .md 出统一页眉页脚的 PDF、要精确参考文献样式、要接进 CI。浏览器转换的甜点区是「个人、偶发、马上要文件」。判断标准:会不会重复做、要不要精确控版式——会且要,上 pandoc;否则浏览器更划算。

小结

Markdown 交付成 Word 或 PDF,是一次结构化转换,不是把预览「拍」进文档。先定交 Word 还是 PDF,再选路径:短内容别靠复制粘贴;偶尔交付用浏览器转换;批量定制用 pandoc。表格、代码、目录、图片这四处先在源码里理顺,导出才少返工。

常见问题

结构化转换(.md → .docx)一般不会乱:标题、列表、代码块、表格会映射成 Word 样式。容易乱的是把预览页整页复制进 Word——带进去的是网页样式,字号和行距常错位。