Notion / Obsidian / GitHub Markdown 互转完整指南：2026 年不再踩坑的转换手册

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

你花3小时在Obsidian写了完美的Markdown文档，有callout、wikilink和LaTeX数学公式。粘到GitHub后callout变成原始HTML，wikilink断了，数学消失了。每个平台都有自己的Markdown方言。

5 种常见 Markdown 方言

1. GitHub 风味 Markdown (GFM)

最广泛使用的方言。增加了表格、任务列表、删除线、自动链接和警告块。被GitHub、GitLab和开发者平台使用。

2. Notion Markdown

专有扩展，有/-commands、行内数据库属性、折叠块和callout。Notion的复制粘贴对简单内容有效，但对复杂结构会出错。

3. Obsidian Markdown

基于CommonMark，用wikilinks做内部链接，YAML frontmatter存元数据。图谱视图严重依赖wikilinks，无法转换到其他平台。

真实转换场景

Obsidian → GitHub

开发者在Obsidian写文档，用wikilinks和callout。转换器将wikilinks翻译为标准markdown链接，Obsidian callout转GFM警告块，保留代码高亮。

Notion → 微信公众号

内容营销人员在Notion写文章，用数据库属性和折叠块。转换器将图片迁移到微信CDN，折叠块转可折叠段落，适配callout。

多平台发布

技术博主在掘金、CSDN、知乎、Medium、GitHub发布同一篇文章。每个平台格式略有不同。批量转换在几秒内生成5个平台专属版本。

选择转换器的关键特性

• 源和目标平台选择
• 图片迁移到平台CDN
• Wiki-link转标准链接
• Callout/警告块翻译
• 批量文件处理
• 目录自动生成
• Mermaid和数学公式支持
• 客户端隐私保护

总结

Markdown碎片化不会消失。但用合适的转换器，你可以写一次发所有平台，不用手动调整格式。关键是找到理解每个平台特定quirks的工具。