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

为什么不能直接把 Markdown 当 Word 发?
因为 .md 是源码,.docx 和 .pdf 是排版成品,两者不在同一层。## 标题 只是标记;对方电脑若没有渲染器,看到的就是带 # 的纯文本,没有字号、目录、页码。客户、导师、行政同事的工作流是 Office 和 PDF,发给他们 .md 等于交半成品。双击 .md 只看到井号,属于打开问题,见下载的 .md 怎么打开;本文只谈交付。
该交 Word 还是 PDF?
对方还要改稿或套模板就交 Word;只要定稿、打印、防止再改就交 PDF。两种格式解决的是不同下游,不是谁更高级。
| 对方要做什么 | 交什么 | 原因 |
|---|---|---|
| 批注、改措辞、套单位模板 | Word(.docx) |
样式可继续编辑 |
| 打印、归档、投稿只收 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一起带走,导出里就会缺图。远程图片若对方服务器禁跨域,可能变成占位图,整份转换不一定失败。 - 篇幅:80–150 页通常稳定;200 页以上按二级标题拆开分别导出再合并,避免一次占满内存。
- 字体:中文 PDF 用转换器内置的宋体/黑体一类更稳。若交的是还要别人继续改的 Word,正文用宋体、微软雅黑、Arial,少用只有你电脑上才有的字体。
什么时候该用 pandoc,而不是浏览器?
要批量、自动化、强模板时用 pandoc:每天从一堆 .md 出统一页眉页脚的 PDF、要精确参考文献样式、要接进 CI。浏览器转换的甜点区是「个人、偶发、马上要文件」。判断标准:会不会重复做、要不要精确控版式——会且要,上 pandoc;否则浏览器更划算。
小结
Markdown 交付成 Word 或 PDF,是一次结构化转换,不是把预览「拍」进文档。先定交 Word 还是 PDF,再选路径:短内容别靠复制粘贴;偶尔交付用浏览器转换;批量定制用 pandoc。表格、代码、目录、图片这四处先在源码里理顺,导出才少返工。
- 双击
.md只看到井号:下载的 .md 怎么打开 - 标题和列表怎么写:Markdown 语法怎么写