你有没有过这种体验：写微信公众号文章调了一下午格式、写知乎回答代码块怎么都对不齐、写README文档不知道怎么加表格？
Markdown就是来解决这些问题的。用纯文本写、简单语法控制格式，写完预览就是排版好的样子。GitHub、知乎、Notion、掘金……几乎所有技术社区都支持Markdown。
今天把Markdown全部语法一次性讲透，每个都有示例和效果说明。
一、为什么用Markdown？
1. 专注内容，不用花精力调格式（不像Word要来回选字号颜色对齐）
2. 跨平台通用，所有编辑器都能打开
3. 纯文本，Git能直接diff修改记录
4. 导出方便，一键转HTML/PDF/Word
5. 程序员标配，写文档、写README、写博客都用它
二、全部语法速查
标题：# 一级标题（到###### 六级），#后有空格
加粗：**加粗文字** 或 __加粗文字__
斜体：*斜体* 或 _斜体_
删除线：~~删除~~
行内代码：`code`（反引号）
代码块：三个反引号包裹，可选语言标记语法高亮
无序列表：- 或 * 或 + 开头，嵌套缩进4空格
有序列表：数字. 开头，嵌套缩进4空格
链接：[链接文字](URL "可选标题")
图片：
引用：> 引用内容（可多级）
分割线：--- 或 *** 或 ___
表格：| 列1 | 列2 | \n| --- | --- | \n| 内容 | 内容 |
脚注：正文[^1]，文末[^1]: 脚注内容
任务列表：- [ ] 未完成 - [x] 已完成
数学公式：行内$E=mc^2$，块级$$公式$$（需要MathJax支持）
流程图/时序图：用Mermaid语法（```mermaid包裹）
高亮：==高亮内容==（部分编辑器支持）
三、实战：写一份产品文档
用Markdown写一份产品需求文档（PRD）：
用#写大标题"XX产品需求文档"，##写章节标题"1.背景与目标"，###写小节"1.1项目背景"。正文用**加粗**强调关键词，用>引用竞品分析，用代码块贴接口示例，用表格列功能清单，用任务列表标开发进度。
一个小时能写完，排版整齐，Git能追踪，导出PDF直接给老板看。比用Word高效太多。
四、Markdown编辑器推荐
VS Code：程序员首选，装"Markdown Preview Enhanced"插件支持流程图数学公式导出PDF，"Markdown All in One"提供快捷键自动补全。
Typora：最流行的独立Markdown编辑器，所见即所得，导出PDF/HTML/Word，免费版够用了。
Obsidian：知识管理神器，支持双向链接和图谱视图，适合做个人知识库。
Notion：支持Markdown但语法有差异（不支持部分高级语法），适合团队协作。
在线编辑器：dillinger.io、markdownlivepreview.com，浏览器直接用。
五、各平台Markdown差异
GitHub：完整支持GFM（GitHub Flavored Markdown），代码块语法高亮、表格、任务列表、删除线都支持。
微信公众号：不直接支持。推荐用"Markdown Nice"（mdnice.com）在线编辑器，复制粘贴到公众号后台保留样式。
知乎：支持基础语法，代码块用```，表格支持但排版一般。
掘金/CSDN：完整GFM支持，是程序员写博客的好地方。
Notion：简化版Markdown，不支持GFM扩展语法，用Notion自己的块概念。
六、避坑清单
❌ #后面一定要有空格→#一级不是#一级
❌ 表格每行列数要一致→否则渲染错乱
❌ 列表嵌套要缩进4空格或一个tab→不要只用2空格
❌ 图片链接要用https://开头的URL→本地图片路径不显示
❌ 不同平台Markdown有差异→写完在目标平台预览
Markdown语法真的很简单，核心就20个标记。学会之后写文档、写博客、写README、写公众号……所有排版问题迎刃而解。建议把VS Code设成默认Markdown编辑器，日常写作都用它，半年后你会发现效率翻倍。晚安，打工人。
