Markdown系列五:md 文档用什么软件写?怎么转成 PDF、发到公众号?

点上方关注，一夜暴富

Markdown 文件能打开，不代表图片能跟着显示；本地预览很整齐，也不代表粘贴到公众号后还是一样。写作和交付之间，还有文件、样式和平台兼容性这几件事。

选工具时可以先看自己要把内容交给谁：给自己长期保存，给同事协作，还是给公众号读者阅读。用途明确之后，软件更容易选。

01 先选一种工作方式

这些是按用途整理的候选，不是排名。工具的收费、配额和功能入口会调整，本文不沿用原稿中的具体价格和“完全免费”承诺，实际使用前以官方页面为准。

先选一款完成真实任务即可。写几篇笔记以后，才能更清楚自己到底需要分屏预览、即时显示，还是更强的文件管理。

Typora 偏向边写边看到格式的体验；VS Code 可以打开 Markdown 预览；Obsidian 更便于组织相互关联的笔记。Notion、飞书文档等工具里的 Markdown 输入快捷方式，也不等于它们就是完整的 .md 文件编辑器。导入、输入和导出，是三个需要分别检查的环节。

02 图片怎样跟着文档走？

假设你这样保存文件：

学习资料/   笔记.md   images/     photo.jpg

在 笔记.md 中写：

![操作步骤截图](./images/photo.jpg)

分享时，把整个“学习资料”文件夹一起打包，对方才有机会按同样的相对位置找到图片。

C:/Users/你的名字/Pictures/photo.jpg 这种绝对路径只在对应电脑环境里有意义。对方没有这个文件，网页平台也无法凭这个地址读取你的硬盘。

网络图片可以使用 HTTPS 地址，但链接可能过期、限制外部引用，或者在发布平台上被拦截。原稿列出的 SM.MS、路过图床和 GitHub 仓库属于不同的存储选择，不宜简单当成永久免费的图床保证。上传前要考虑素材使用许可、文件是否适合公开，以及服务的访问规则。

本地存储也不等于自动备份或加密。重要笔记应有备份，设备丢失和误删除都不会因为文件是 Markdown 就自动避免。

03 发公众号，复制的是排版结果

公众号编辑器通常不会把粘贴进去的整篇 Markdown 源码直接解析成文章。常见做法是先通过 mdnice 等工具，将 Markdown 渲染为带样式的富文本，再复制到公众号编辑器。

操作可以按这个顺序走：

1. 把正文放进排版工具，先确认标题、段落、列表都识别正确。

2. 选择一个稳定、简洁的主题，统一字号和间距。

3. 使用工具提供的公众号复制功能，粘贴到公众号编辑器。

4. 在后台检查图片、表格、代码块和链接，保存草稿。

5. 发送手机预览，检查长行、宽表格和段落密度。

工具的按钮名称可能变化，关键是复制“排版后的内容”，而不是把带井号和反引号的源码当成成品粘过去。

对教程文章，可以让正文保持稳定字号，章节用少量编号与强调色区分，步骤仍按普通列表显示。代码块保留缩进；表格能用两三列说清楚，就不横向堆出七八列。屏幕上的留白，是让读者分清段落，不是给每句话加一个彩色框。

公式、Mermaid、折叠内容和目录跳转需要单独处理。公众号不一定保留编辑器中的交互与渲染能力。转换成图片时检查清晰度；系列导航则应使用实际可访问的文章链接，本地 .md 文件名不能直接给公众号读者点击。

04 导出 PDF 和发布到其他平台

Typora 等工具提供 PDF 导出路径；VS Code 也可以借助相应扩展完成。导出能力和菜单位置与工具版本有关，在线编辑器还应检查当前是否提供所需格式。

导出后重新打开 PDF，看看代码是否被截断、图片是否缺失、表格是否跨页。Markdown 决定内容结构，PDF 的分页和样式仍由导出工具处理。

项目说明可以放在 GitHub 仓库中。GitHub 能渲染 Markdown 文件，也会在符合规则的位置展示 README。它并不限于 Markdown 格式的 README，原稿的“README 都是 Markdown”说法过于绝对。

向掘金、CSDN、博客园、知乎或简书发布时，也应分别确认当前编辑器是否支持源码、导入或其他转换方式，不能因为它们是内容平台，就假定同一段源码可以直接使用。

05 格式不对，先查这些位置

标题还是井号：检查是否处于预览模式，井号后有没有空格，以及它是否意外落在代码块内。

后半篇全变成代码：检查代码围栏有没有闭合；教程中展示代码块时，外层围栏应比内层更长。

换行消失：单次回车可能只是软换行。不同段落之间空一行；确实需要同段换行时，再使用目标平台支持的写法。

图片显示失败：先检查文件是否存在、相对路径从哪里算起，再检查网络链接是否可访问。不要只凭源文件里“有一行图片语法”就认定图片已经发出。

表格、公式或流程图失效：先检查目标平台是否支持相应扩展。把它们拆成更通用的段落或图片，有时比继续调整标点有效。

06 留一张自己的速查表

快捷键和语法不是同一回事。快捷键由编辑器、操作系统、键位设置和插件决定，不能把某个软件的一张快捷键表当成通用规则。常用命令可以从当前编辑器菜单里查看，再补进自己的笔记。

原稿建议按天练习，这里改成按任务推进：先完成一篇笔记，再做一份会议记录，然后尝试带图片分享或导出 PDF。每遇到一种实际问题，再补学对应语法。

想继续查阅，可以从这些入口开始：

• CommonMark 规范（https://spec.commonmark.org/）

• GFM 规范（https://github.github.com/gfm/）

• GitHub 文档：基本写作和格式语法（https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax）

• Markdown 中文教程（https://markdown.com.cn/）

• Typora（https://typora.io/）、Obsidian（https://obsidian.md/）、VS Code（https://code.visualstudio.com/）

• Dillinger（https://dillinger.io/）、StackEdit（https://stackedit.io/）、mdnice（https://mdnice.com/）

真正值得保留下来的，是一份以后仍能找到、看懂和修改的文档。工具可以更换，自己整理的内容和示例应该能够带走。