🌱 纯文本 · 可读可写 · CommonMark 0.30 事实标准 · GitHub/VSCode/Obsidian 全原生

为什么是 Markdown

极简到一眼读懂，强大到撑起整个文档生态

✎

纯文本可读

没有标签噪音，未渲染也能直接读，Git diff 友好。

⇄

一键转 HTML

marked/Pandoc/CommonMark 参考实现，秒出干净网页。

#

7个核心语法

标题/段落/列表/链接/图片/粗体/斜体，10分钟学会。

▦

GFM 扩展

表格、任务列表、删除线、代码块、自动链接全支持。

∞

全平台原生

GitHub/VSCode/Obsidian/Notion/Typora 零配置。

⚙

机器可解析

AST 稳定、CommonMark 无歧义，适合静态站点与CI。

写一次，到处渲染

同一份 .md → HTML / PDF / Slide / DOCX

Pandoc 支持 40+ 格式互转；GitHub 自动渲染 README；Hugo/VuePress 直接生成整站——写作与发布彻底解耦。

2004 年至今
数百万项目在用

Markdown → HTML

## Title **Bold** and *italic* - item A - item B → <h2>Title</h2>
→ <strong>Bold</strong>
→ <ul><li>A</li>…</ul>

无处不在的渲染场景

📦 GitHub README

仓库首页自动渲染，表格/徽章/目录开箱即用。

📝 技术文档

VuePress/Docusaurus/MkDocs 全站由 .md 生成。

📖 个人笔记

Obsidian/Logseq 双向链接+MD，本地优先。

✉️ 邮件与评论

Reddit/Discord 支持 MD，富文本零学习成本。

30秒写出第一篇

1

开记事本

任意.txt/.md

2

写 # 与 **

7个核心语法

3

粘到渲染器

marked/GitHub

4

发布网页

干净HTML

标准与生态

规范版本定位解析器
Gruber 原版1.0.1宽松·写给人类原始 Perl
CommonMark0.30无歧义·事实标准cmark / marked
GFM随GitHub表格/任务列表github/marked
Pandoc MD3.x学术/扩展pandoc

进阶写法

📊 表格与任务

| 列 | 列 | 与 - [ ] 任务，GFM 一键渲染。

🔗 脚注与引用

[1](@ref) 脚注、> 引用块，长文也清晰。

🧮 数学与Mermaid

$E=mc^2$ 与流程图，Obsidian/VuePress支持。

常见问题

Markdown 最新版本是多少？
John Gruber 原版停在 1.0.1；CommonMark 定稿 0.30（2019-04-06），是目前跨平台事实标准，GFM 随 GitHub 持续演进。
需要安装软件才能写吗？
不需要——记事本/VS Code/手机备忘录都能写 .md，只需一个渲染器转 HTML，零依赖。
CommonMark 和原版有什么区别？
CommonMark 消除歧义、配官方测试集，保证不同解析器输出一致；原版更宽松、允许多种写法。
GFM 比标准多了什么？
表格、任务列表、删除线、自动链接、代码高亮、HTML 净化，是 GitHub 的官方超集。
能转成 PDF / Word 吗？
可以，Pandoc 支持 40+ 格式互转；Typora/VSCode 也能直接导出 PDF。
适合写论文或技术书吗？
适合，配合标题锚点、引用、数学公式（KaTeX）可写技术文档与长文，Hugo 直接出站。
有官方 APP 吗？
Markdown 是格式不是 APP；官方只提供 cmark 参考解析器，编辑器任选 Typora/Obsidian。
中文排版要注意什么？
中英文间加空格更美观，标题用 #，列表用 -，引用用 >，GFM 对中文完全友好。