Markdown 平台转换器指南：在 Notion、GitHub、Obsidian 间同步文档

为什么 Markdown 在每个平台上看起来都不一样

你在 GitHub 写了干净的 README，粘贴到 Notion 后表格全塌了。你把 Obsidian 的 wiki 链接 [[页面名]] 复制到 Reddit，结果看到字面方括号。Markdown 本被宣传为通用格式，但每个平台都自带方言：GitHub 加了任务列表和删除线，Notion 把块重写成自己的模型，Obsidian 加了 wiki 链接和脚注，Reddit 剥离了原始 HTML。平台转换器在这些方言之间翻译，让你的格式在传输中存活。

Markdown 方言问题

GitHub 风味 Markdown (GFM)

GFM 是开发者事实上的标准。它加了表格、任务列表（- [x] done）、删除线（~~text~~）、URL 自动链接和带语言提示的围栏代码块。大多数静态站点生成器和 README 文件都期望 GFM。如果你在别处写再粘到 GitHub，通常会获得功能——但反向通常会丢失。

Notion Markdown

Notion 的 Markdown 导入是有损的。它接受基本语法但在保存时把块重写成自己的数据库模型。表格变成 Notion 数据库，标注变成特殊块，wiki 链接不能往返。从 Notion 导出 Markdown 常产生怪异语法，如嵌套复选框和冒号前缀的标注，在其他平台上会坏。

Obsidian

Obsidian 用 wiki 链接（[[页面名]]）、块引用（^block-id）、嵌入（![[image.png]]）和脚注（[^1]）扩展了 Markdown。这些对个人知识管理很强大，但粘贴到 GitHub、Reddit 或 Medium 时会完全坏掉，因为那些平台把方括号当字面文本。Obsidian 还支持内联标签（#tag），大多数平台不识别。

常见转换挑战

• 表
• 任
• W
• 代
• 脚
• 图

平台转换如何工作

好的 Markdown 平台转换器会把你的源文本解析成抽象语法树（AST），识别方言特定功能，然后以目标方言重新输出内容。Wiki 链接变成标准链接，Obsidian 嵌入变成图片标签，Notion 标注变成引用块，GFM 任务列表适配目标平台支持的形式。最好的转换器完全在浏览器中运行——无需服务器上传，无数据泄露，即时结果。

跨平台写作技巧

面向最低公共标准写作

如果你需要内容在所有地方都可用，坚持用 CommonMark：标题、段落、粗体、斜体、列表、标准链接、标准图片和不含语言提示的围栏代码块。避免 wiki 链接、脚注、任务列表和表格，除非你确定目标支持它们。必须用高级语法时，用转换器来桥接差距。

粘贴前先测试

在迁移整篇文档前，先粘贴一小段测试。不同平台会静默剥离未知语法，在你编辑器里看起来好的内容可能在目标平台渲染成垃圾。30 秒的测试能省一小时的重新格式化。随手备一个转换器做快速方言检查。

总结

Markdown 碎片化是每个技术作者和开发者最终都会遇到的痛点。一旦你理解每个平台支持哪些方言功能，你就可以防御性地写作，用转换器来桥接差距。我们的浏览器 Markdown 平台转换器完全在客户端运行——你的笔记、文档和草稿永远不会离开你的设备。粘贴进来，选个目标，得到干净输出。