Markdown 语法速成：15 分钟学会写作圈通用格式

Notion、飞书文档、GitHub、掘金、语雀——这些平台全都支持 Markdown。它不是软件，是一套用纯文本符号标记格式的约定：写的时候是符号，渲染之后是排版。学会一次，处处可用。

一、十个高频语法，覆盖 95% 的场景

写法	效果
# 标题（## 二级，### 三级）	标题，# 后要有空格
**加粗**	加粗
*斜体*	斜体
- 列表项	无序列表
1. 列表项	有序列表
[文字](网址)	超链接
	插入图片
`代码`	行内代码
三个反引号包裹的多行	代码块
> 引用内容	引用块

二、三个容易踩坑的细节

1. 符号后要有空格：标题的 #、列表的 - 之后必须跟一个空格，#标题 不会被渲染成标题。这是新手第一大坑；
2. 列表的嵌套靠缩进：子列表用 2–4 个空格缩进（不同渲染器容忍度不同，统一用 4 个最稳）。Tab 和空格混用会导致渲染错乱；
3. 空行是段落分隔：Markdown 里单个回车不会分段，两段之间要空一行。想让一段内强制换行，行尾加两个空格，或干脆拆成两段。

三、实战：一份会议纪要的标准写法

# 3 月产品周会纪要
**时间**：2026-03-04 10:00–11:00
**参会**：产品、前端、测试

## 结论
1. v2.3 上线时间定为 **3 月 18 日**
2. 缺陷清单以测试组邮件为准

## 待办
- [ ] 前端：修复搜索高亮（负责人：小王）
- [ ] 产品：补充埋点文档（负责人：小李）

渲染后就是一份层级清晰的纪要。其中 - [ ] 是任务列表语法，GitHub 和多数现代编辑器会渲染成可勾选的复选框。

四、进阶两招

1. 表格：用竖线分隔列、第二行写三个减号定表头：| 姓名 | 分数 | 下一行 |---|---|，之后每行一行数据；
2. 转义：想显示星号本身而不是加粗，前面加反斜杠 \*。写说明文档时常用。

五、用 Markdown 管理长期文档

单篇会用只是入门，长期积累后文件管理才是关键。三个经过验证的实践：

1. 文件名带日期与主题：2026-10-08-周会纪要.md 这样的命名让文件管理器里天然按时间排序，搜索时也能用日期快速过滤。避免「新建文档 1.md」这种名字，三个月后你自己都不知道里面是什么；
2. 一篇一个主题，标题即目录：长文档用二级标题切分，很多编辑器（包括本站的 Markdown 编辑器）会自动从标题生成大纲侧栏，写的时候思路也不容易散；
3. 纯文本是终极优势：Markdown 文件十年后依然能打开，不依赖任何软件存活。重要笔记用它做主格式，需要分享时再导出 PDF 或 Word，这份「源文件」就是你的数字资产。

迁移成本几乎为零：任何编辑器都能写，git 能管版本，同步盘能做备份。这也是为什么技术圈、学术圈和越来越多普通写作者把它当默认格式。

常见问题

问：不同平台的 Markdown 渲染不一样怎么办？
核心语法（标题、粗体、列表、链接、代码块）全平台一致，差异集中在任务列表、脚注、数学公式等扩展语法。要跨平台发布就只用核心语法。

问：Word 能转 Markdown 吗？
可以用工具转，但复杂排版（表格套单元格、艺术字）会丢失。反过来 Markdown 转 Word 几乎无损，这是它作为「写作源格式」的优势。