Markdown 编辑器完整教程：语法 + 实战
学会 Markdown 后，写博客、文档、笔记效率翻倍。本指南覆盖标准语法、GFM 扩展、技术写作技巧。
Markdown 是 2004 年由 John Gruber 设计的轻量级标记语言，目标是「易读易写、转 HTML 友好」。如今 GitHub、知乎、各种博客系统都原生支持。本指南配合本站 Markdown 编辑器讲清楚所有常用语法。
基础语法 8 条
- 标题：
#一级到######六级 - 粗体：
text/ 斜体：text/ 删除线：~~text~~ - 链接：
[文字](URL)/ 图片： - 行内代码：`
- 引用：
> 引用内容 - 无序列表：
- 项目/ 有序列表：1. 项目 - 分隔线：单独一行三个
--- - 转义：
\*显示星号本身
GitHub Flavored Markdown 扩展
GFM 在标准之上加了：
- 表格：|+ --- 分隔头部
- 任务列表：- [x] 已完成 / - [ ] 待办
- 删除线：~~text~~
- fenced code 带语言： `javascript 启用语法高亮
- 自动链接：纯 URL 自动转链接
- emoji：:smile: → 😄（看渲染器支持）
技术写作 5 个技巧
- 标题层级不要跳级：H2 之后是 H3，不要直接 H4
- 代码块带语言名：让搜索引擎和阅读器知道语言
- 链接锚点：标题自动生成 id，文中可用
[跳到第二节](#二级标题) - 图片用相对路径：方便仓库迁移；如发布到 CDN，用绝对路径
- 避免 HTML 混用：标准 Markdown 容器都能渲染时，少用原生 HTML 标签
Markdown ↔ HTML 转换
本工具基于 marked + DOMPurify： - marked：把 MD 转成 HTML - DOMPurify：清洗 HTML，防 XSS - turndown：HTML 反向转 MD
反向转换适合从富文本编辑器迁移到 Markdown 体系。
部分高级语法
- 数学公式：
$E=mc^2$行内、$$...$$块级（需 KaTeX/MathJax） - 流程图：mermaid 语法，
mermaid graph TD; A-->B - 脚注：
[^1]在文末[^1]: 脚注内容 - 高亮：
==text==（部分支持）
常见问题
Markdown 和富文本编辑器哪个好？
技术文档、博客、API 文档用 Markdown；销售物料、复杂排版用富文本。Markdown 优势：版本可控、易迁移。
GFM 与 CommonMark 有什么区别？
CommonMark 是 Markdown 标准化版本。GFM = CommonMark + GitHub 扩展（表格、任务列表、删除线、自动链接）。
能写带样式的 Markdown 吗？
部分渲染器支持嵌入 HTML，但通常不推荐——失去 Markdown 平台无关性的优势。