📘 Markdown 保姆级语法手册

覆盖

99%+ 日常写作场景

的 Markdown 全量指南。
本手册在「保姆级手册」基础上，融合了图文长版的精华（Emoji、快捷键、FAQ 等），查漏补缺后形成一份终极版本 —— 从零基础到高手，一份就够。

---

目录

• 写在前面：先建立正确认知

• 第一部分：编辑器与工具链

• 第二部分：核心语法（覆盖 90% 场景）

  • 1. 标题

  • 2. 段落与换行

  • 3. 文字样式

  • 4. 列表

  • 5. 引用

  • 6. 代码

  • 7. 分割线

  • 8. 链接

  • 9. 图片

• 第三部分：进阶语法（搞定剩余 9%）

  • 10. 表格

  • 11. 转义字符

  • 12. HTML 内嵌

  • 13. 脚注

  • 14. 目录 TOC

  • 15. 数学公式（LaTeX）

  • 16. Mermaid 图表

  • 17. Emoji 表情

• 第四部分：效率、规范与避坑

  • 18. 常用快捷键

  • 19. 写作规范建议

  • 20. 常见问题 FAQ

  • 21. 常见坑速查表

  • 22. 跨平台兼容性

• 第五部分：实战场景模板

• 附录：一页速查表

---

写在前面：先建立正确认知

Markdown 是一种「轻量级标记语言」（2004 年由 John Gruber 设计）。它用极简的符号代替鼠标排版，输出一份纯文本文件，这份文件同时是：

• 人类可读：记事本都能打开，不依赖任何软件；

• 机器可解析：GitHub、语雀、飞书、Typora、VSCode、Obsidian 都能渲染成网页 / PDF / Word；

• 极低学习成本：核心语法几十个符号，几分钟上手。

文件后缀：.md（也有部分用 .markdown）。

广泛用于：GitHub、掘金、CSDN、Notion、语雀、Typora、Obsidian 等。

⚠️

必须先分清：Markdown 没有「唯一标准」
CommonMark

：最通用的基础标准，所有平台都支持；
GFM（GitHub Flavored Markdown）

：GitHub 扩展的语法（表格、任务列表、删除线、自动链接等），是事实行业标准；
平台私有扩展

：Typora、语雀、飞书、Obsidian 各自加的语法，

换平台可能不生效

。
本手册会

明确标注

每项语法是「通用」还是「扩展」，避免你换平台踩坑。

---

第一部分：编辑器与工具链

写 Markdown 任何文本编辑器都行，但支持实时预览的工具体验天差地别。按需选择：

💡

关键概念

：Markdown 有「源码」和「预览」两种形态 —— 你敲的是符号，看到的是渲染结果。学习时边敲边看预览，最快。

---

第二部分：核心语法（覆盖 90% 场景）

这是基本功，学完即可写 90% 的文档。

1. 标题

用 # 表示，# 的个数代表级别，共 1～6 级。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

规则要点：

• # 与标题文字之间必须有一个空格，否则部分解析器不识别；

• # 标题 ✅，#标题 ❌；

• 每篇文档建议只用一个一级标题（即文档标题），其余用二级及以下；

• 标题层级不要跳级（不要从 ## 直接跳到 ####）。

另一种写法（Setext 下划线式，仅 1～2 级）：

一级标题（用 === 下划线）
==================

二级标题（用 --- 下划线）
------------------

⚠️

---

单独成行会被当成「分割线」而不是标题。日常统一用

#

写法最稳妥。

---

2. 段落与换行

• 段落：连续文字块，段落之间用一个空行隔开；

• 软换行（段内换行）：行尾加两个空格再回车；

• 有些编辑器（如 Typora）直接回车即换行，但纯 Markdown 源码下不生效，跨平台建议用两个空格。

这是第一段。

这是第二段（因为上面空了一行）。

这是同一段内的
强制换行（行尾两个空格  ）

⚠️

新手最常踩的坑

：Markdown 里单个回车

不会

产生新段落（和 Word 的直觉不同）。要分段必须空一行。

---

3. 文字样式

嵌套组合示例：

**粗体里的*斜体*效果**

效果：粗体里的斜体效果

⚠️ 符号与文字之间

不要有空格

：

*斜体*

✅，

* 斜体 *

❌。

---

4. 列表

4.1 无序列表

用 -、*、+ 任一开头 + 空格：

- 苹果
- 香蕉
- 橙子

4.2 有序列表

用 数字. + 空格。数字不必连续，Markdown 自动重编号；但建议按顺序写，方便阅读源码。

1. 第一步
2. 第二步
3. 第三步

4.3 嵌套列表

子项缩进 2 或 4 个空格（或一个 Tab）：

- 前端
  - HTML
  - CSS
  - JavaScript
- 后端
  1. Java
  2. Python

4.4 列表中的段落（多行补充说明）

在列表项内换行写补充说明时，新段落要缩进对齐（与 - 后的文字对齐），否则列表会断裂：

- 第一项

  这是第一项的补充说明（缩进对齐，属于上一项）。

- 第二项

4.5 任务清单（Todo List）

GFM 扩展，用 - [ ]（未完成）和 - [x]（已完成）：

- [x] 已完成任务
- [ ] 未完成任务
- [ ] 待办事项

多用于 GitHub Issue、PR、项目计划。在支持的平台里可以直接点击勾选。

---

5. 引用（Blockquote）

用 > 开头，可多行、可嵌套：

> 这是一段引用。
> 这是第一层引用
>
> > 这是嵌套的第二层引用

引用内可包含其他语法（斜体、代码、链接、列表等）：

> **注意：** 引用里也能用 *斜体*、`代码`、[链接](https://example.com)。

⚠️ 引用中间的

空行也要带

>

，否则引用会中断。

---

6. 代码

6.1 行内代码

用一对反引号 ` 包裹：

请使用 `console.log()` 打印日志。

若代码本身含反引号，用

两个反引号

包裹：

code

。

6.2 代码块（围栏式，推荐）

用三个反引号 ``` 包裹，推荐写明语言以触发语法高亮：

```javascript
function hello(name) {
  console.log(`Hello, ${name}!`);
}
hello("World");
```

常用语言标识： javascript、typescript、python、java、go、c、cpp、csharp、bash、shell、sql、html、css、json、yaml、xml、markdown、diff。

6.3 缩进式代码块（旧写法，了解即可）

在每行前加 4 个空格或 1 个 Tab 也能表示代码块，但不推荐—— 不如围栏通用、不支持语法高亮、无语言标识。

6.4 在代码块里展示反引号（嵌套围栏）

代码块里若要展示 ``` 本身，用更多反引号（4 个）包裹外层即可：

````markdown
```python
print("嵌套示例")
```
````

---

7. 分割线

用三个及以上连续的 -、* 或 _，单独成行：

---

***

___

⚠️ 分割线上方若紧贴文字，可能被误识别为二级标题，建议

上下各空一行

。

---

8. 链接

8.1 行内式（最常用）

[链接文字](https://www.example.com)

[带悬停提示的链接](https://www.example.com "悬停提示文字")

8.2 参考式（长文管理利器）

URL 不写在正文，集中在文末定义，正文保持干净：

[百度][1] 和 [Google][google] 是常用搜索引擎。

[1]: https://www.baidu.com
[google]: https://www.google.com

8.3 自动链接

<https://www.baidu.com>
<someone@example.com>

8.4 锚点跳转（页内跳转）

[跳转到"表格"一节](#表格)

锚点规则：

• 标题转锚点：英文小写、空格变 -、去除特殊符号（如 # My Section → #my-section）；

• 中文标题多数平台直接用标题原文（如 #表格）；

• 不同平台略有差异。

---

9. 图片

语法与链接几乎一样，前面多一个 !：

9.1 基本语法

![替代文字](图片地址)

![替代文字](图片地址 "悬停标题")

9.2 本地图片 / 网络图片

![Logo](../images/logo.png)        <!-- 本地相对路径 -->
![风景](https://picsum.photos/200/100)  <!-- 网络图片 -->

9.3 带链接的图片（图片可点击跳转）

[![图片](图片地址)](跳转地址)

9.4 控制尺寸（HTML 写法）

<img src="https://picsum.photos/200/100" width="200" height="100" />

💡

工程建议

：图片统一放在

images/

或

assets/

目录，用相对路径引用，方便文档迁移和版本管理。替代文字永远写上（加载失败时显示）。

---

第三部分：进阶语法（搞定剩余 9%）

10. 表格

GFM 扩展。用 | 分隔单元格，第二行用 --- 分隔表头：

| 姓名 | 年龄 | 城市 |
| :--- | :--: | ---: |
| 张三 |  25  | 北京 |
| 李四 |  30  | 上海 |

渲染：

对齐方式：

注意事项：

• 第二行的 --- 分隔行是必须的，不能省；

• 各行列数要一致；

• 单元格内写竖线 | 需转义为 \|；

• 单元格内可放 **粗体**、[链接](url)、`代码`；

• 单元格内换行用 <br>。

---

11. 转义字符

想原样显示 Markdown 符号，用反斜杠 \ 转义：

\*这不是斜体*
\# 这不是标题
\[这不是链接](不是链接)

可转义字符清单：

\  `  *  _  {  }  [  ]  (  )  #  +  -  .  !  |  >  <  ~

---

12. HTML 内嵌

Markdown 允许直接写 HTML—— 这是「万能兜底」，Markdown 语法满足不了时用它：

<div style="color: red;">红色文字</div>

<details>
  <summary>点击展开</summary>
  隐藏内容……
</details>

<br>

<kbd>Ctrl</kbd> + <kbd>C</kbd>

常用标签： <br> 换行、<kbd> 按键样式、<sub>/<sup> 上下标、<div> 块容器、<details>/<summary> 折叠块、<img width="300"> 图片尺寸。

⚠️

GitHub 的 README 会过滤部分 HTML 和内联样式

，需谨慎使用；语雀、飞书支持度也不同。

---

13. 脚注

部分平台（GitHub、Typora、Obsidian）支持：

这是一句话，后面有脚注。[^1]

[^1]: 这是脚注的具体内容。

💡 适合论文、长文做补充说明，但并非所有在线笔记都支持，正式文档前先确认。

---

14. 目录 TOC

自动目录标记： 部分编辑器支持直接写 [TOC] 自动生成目录：

[TOC]

手动写锚点目录：

- [标题一](#标题一)
- [标题二](#标题二)

⚠️

GitHub 默认不渲染

[TOC]

标记

；Typora、语雀、掘金、Obsidian 支持。长文在 GitHub 上建议手写锚点目录。

---

15. 数学公式（LaTeX）

用 LaTeX 语法，$...$（行内）或 $$...$$（块级）：

行内公式：$E = mc^2$

块级公式：
$$
\int_{a}^{b} f(x)\ dx = F(b) - F(a)
$$

常用示例：

💡 支持情况：Typora、Obsidian、掘金、CSDN 支持；GitHub 已原生支持基础

$...$

渲染。复杂宏包各平台差异大，建议实测。

---

16. Mermaid 图表

用文字描述图表，GitHub、GitLab、语雀、Typora 均支持。

流程图：

```mermaid
flowchart TD
    A[开始] --> B{判断}
    B -->|是| C[执行]
    B -->|否| D[结束]
    C --> D
```

时序图：

```mermaid
sequenceDiagram
    用户->>服务器: 发送请求
    服务器-->>用户: 返回响应
```

饼图：

```mermaid
pie title 水果销量
    "苹果" : 40
    "香蕉" : 30
    "橙子" : 30
```

💡 还支持甘特图、类图、状态图、ER 图等，需要时再深入。

---

17. Emoji 表情

两种方式：

1. 直接粘贴 Unicode 字符（任何平台都显示）：😀 🚀 🎉 ❤️ ⚠️ 💡 ✅ ⭐ 🔥；

2. :emoji: 短代码语法（GitHub、GitLab、Slack、部分平台支持）：

:smile: :rocket: :tada: :heart:

常用 Emoji 速查：

💡 想在其他平台也稳显示，

直接粘贴 Unicode 表情最保险

；完整短代码表可搜「emoji cheat sheet」。

---

第四部分：效率、规范与避坑

18. 常用快捷键

Typora / VSCode 等编辑器通用（Windows 用 Ctrl，macOS 用 Cmd）：

---

19. 写作规范建议

1. 标题层级清晰：一级标题只用一个，层级不跳级、不超过 4 层；

2. 段落之间空一行：避免渲染错乱；

3. 代码块标明语言：便于高亮，提升可读性；

4. 图片用相对路径：方便迁移与版本管理；

5. 中英文之间加空格：使用 Markdown 写作 比 使用Markdown写作 更易读；

6. 善用引用与列表：结构化表达，读者更易理解；

7. 统一风格：列表统一用 -，粗体统一用 **；

8. 提交前预览：不同平台渲染差异大，发出去前务必预览一遍。

---

20. 常见问题 FAQ

Q1：为什么我的换行没生效？

Markdown 把单个回车当作空格。请在行尾加两个空格，或直接空一行分段。

Q2：为什么 # 没变标题？

# 与文字之间必须有空格：# 标题 ✅，#标题 ❌。

Q3：表格为什么渲染不出来？

检查分隔行 | --- | --- | 是否存在、每行列数是否一致。

Q4：图片为什么显示不出来？

检查路径、大小写、文件名是否含中文或空格；网络图片检查链接是否可直接访问。

Q5：为什么有的语法不生效？

不同平台支持范围不同（如 GitHub 不渲染 [TOC]、部分平台不支持 ==高亮==），需查阅目标平台文档。

Q6：如何写一个反引号？

用双反引号包裹： ` 。

Q7：如何在表格里写竖线 |？

用 \| 转义。

Q8：Markdown 和 HTML 能混用吗？

可以，绝大多数平台支持；但部分平台（如 GitHub README）会过滤部分 HTML。

---

21. 常见坑速查表

---

22. 跨平台兼容性

1. 优先用通用语法：标题、列表、粗斜体、引用、代码、链接、图片、分割线 —— 任何平台都支持，放心用；

2. 谨慎用扩展语法：表格、删除线、任务列表、脚注、公式、Mermaid、Emoji、[TOC]—— 主流平台支持，个别老编辑器不支持；

3. 标注扩展：文档可能被不同工具打开时，对扩展语法加注释说明；

4. 一个文件一个主标题，层级不乱，方便自动目录和锚点。

---

第五部分：实战场景模板

直接复制改成自己的内容即可。

模板一：技术文档 / README

# 项目名

> 一句话介绍这个项目是做什么的。

## 功能特性

- 特性一
- 特性二

## 快速开始

### 环境要求

- Node.js >= 18

### 安装

```bash
npm install

API 文档

### 模板二：日报 / 周报

```markdown
# 工作周报（10.13 ~ 10.17）

## 本周完成

- [x] 需求评审
- [x] 首页改版开发
- [ ] 联调测试（进行中）

## 下周计划

1. 完成联调测试
2. 上线发布

## 风险

> ⚠️ 接口联调延迟，可能导致上线延期。

模板三：学习笔记

# 标题：数据库索引原理

## 核心结论

> 索引是数据库为加速查询建立的数据结构。

## 关键点

- **主键索引**：唯一且非空
- **复合索引**：最左前缀原则

## 示例

```sql
CREATE INDEX idx_name ON users(name);

---

## 附录：一页速查表

```markdown
# 标题1 ~ ###### 标题6
**粗体**  *斜体*  ***粗斜体***  ~~删除线~~  ==高亮==  `行内代码`

- 无序列表
1. 有序列表
- [ ] 任务    - [x] 已完成

> 引用
>> 嵌套引用

[链接](url "标题")
![图片](url)
[![图片](图片地址)](跳转地址)

| 表头 | 表头 |
| --- | --- |
| 内容 | 内容 |

---

```语言
代码块

$行内公式$ $块级公式$

:emoji: [^ 脚注]

---

> 🎉 **恭喜！** 掌握以上内容，你已经能应对 99% 的 Markdown 写作场景。
> 建议边看边在编辑器里亲手敲一遍，印象更深。✍️

长期定投执行手册

行动路径：每月8日扣款——场内 1 笔中证A500（1800 元）+ 场外 5 笔自动定投；每月看估值分位调节金额，季度检查比例做再平衡，止盈严格按纪律分批执行。组合悲观回撤约 -38.6%，控制在 40% 承受线以内。

---

1. 投资定位与总纲

目标与约束。 长期定投 5 年以上，月投 3000–5000 元（本方案按基准 4000 元测算），可承受最大回撤 40%，资金为可长期不动的闲钱。账户为同花顺证券账户，佣金不免最低 5 元，因此执行上采用场内大额 + 场外自动定投的混合模式，避开小额定投被 5 元最低佣金侵蚀。

核心配置逻辑。 宽基核心（中证A500 45%）打底，成长卫星（恒生科技 14%、创新药 10%、科创芯片 10%、港股创新药 5%）博弹性，红利低波 10% 做防御缓冲，货币备用 6% 做承接池与加码弹药。整体定位为进取型，进攻 39%、防守 16%，与 40% 回撤承受能力匹配。

估值起点（2026-09-30 口径）。 中证A500 市盈率约 15.6 倍、近 1 年约 20% 分位，恒生科技动态市盈率约 14.6 倍、约 7% 分位，均处于历史低位区，当前处于正常定投甚至可加码的阶段，是开始执行的好时点。

2. 仓位方案

2.1 仓位总览

七类资产权重与月投金额如下（基准月投 4000 元）：

pie title 组合仓位构成（月投4000元基准）
    "中证A500" : 45
    "恒生科技" : 14
    "创新药A股" : 10
    "科创芯片" : 10
    "港股创新药" : 5
    "红利低波" : 10
    "货币备用" : 6

2.2 代码与金额明细

场外定投优先选择 C 类份额（如 012782、019671、013309），持有 7 天以上免申赎费，仅收销售服务费，长期定投成本更低；A 类适合长期大额一次性买入。

2.3 组合悲观回撤测算

用各资产的悲观情景跌幅（取自历史最大回撤近似下沿）按权重加权：

该测算为悲观情景估算，非预测；定投期实际回撤还会被持续买入摊薄。若单一资产跌幅超出假设且逻辑未变，按第七部分压力预案执行。

3. 买入调节：估值分位机制

每月扣款前检查各标的指数估值分位，按区间调节金额。每个标的独立判断（中证A500 看自身分位、恒科看恒科分位），不互相抵消。

每月动作。 在扣款前 1 天看一次估值分位（同花顺/天天基金均有指数估值页），在月度记录表里记下分位数字；只有触发区间变化才调整金额，其余时间不看盘。

4. 止盈纪律

定投 5 年以上的止盈主要发生在牛市中后段，核心原则是分批、分档、回笼：永远不清仓离场，落袋资金回到货币池与低波动资产，等待下一次低位。

4.1 三层止盈规则

4.2 止盈资金去向

• 第一优先：转入货币备用池，作为下跌期的加码弹药；
• 第二优先：转入红利低波等低波动资产，锁定利润、增强防御；
• 不用于消费：除非达到年度复盘设定的总收益目标（如累计收益翻倍），否则利润继续在组合内滚动。

4.3 亏损纪律

定投期内永不止损。 下跌不是风险，是摊低成本的机会——估值分位越低越要按计划买入，唯一允许的动作是停加（估值过高时），不是割肉。唯一例外：标的逻辑被证伪（指数停止发布、基金规模持续低于 1 亿、跟踪误差显著恶化），才按附录纠错流程更换为同类龙头。

5. 执行纪律

5.1 渠道分工与佣金对策

同花顺每笔最低 5 元佣金，对低于 1000 元的小额定投侵蚀很大（200 元一笔占 2.5%）。因此按金额分渠道：

5.2 每月操作清单

• 每月 7 日：查看各指数估值分位，确认是否需要调节金额
• 每月 8 日：场内手动买入中证A500 1800 元；确认场外 5 笔自动定投扣款成功
• 确认货币备用 240 元已留存（可从工资卡单独转入货基）
• 在月度记录表登记：各标的净值、估值分位、扣款是否正常（约 5 分钟）

5.3 禁止事项

• 禁止追涨杀跌：不因单日涨跌改变计划，只看月度估值分位；
• 禁止一次性重仓：新增资金按比例分批进入，不赌时点；
• 禁止借贷、信用卡或应急金入市：定投资金必须是可以 5 年不动的闲钱；
• 禁止频繁调仓：每年最多调整一次目标比例，换标的一年内不超过一次；
• 禁止高频看盘：每月只看一次估值，把注意力留给工作和生活。

6. 复盘与调整

6.1 复盘节奏

6.2 调整触发条件

6.3 执行闭环

四环节每月循环：扣款 → 估值调节 → 止盈判断 → 复盘再平衡，条件触发时按分支执行：

flowchart TD
    A[① 每月8日扣款<br/>场内A500 1800元 + 场外5笔自动定投] --> B[② 估值分位检查]
    B -->|分位低于30%| C[正常定投，可加码50%]
    B -->|30%-70%| D[正常定投]
    B -->|70%-85%| E[该标的定投减半]
    B -->|高于85%| F[暂停新增，启动分批止盈]
    C --> G[③ 止盈判断]
    D --> G
    E --> G
    F --> G
    G -->|组合收益≥50%后高点回撤15-20%| H[落袋1/3利润]
    G -->|卫星收益≥100%后回撤30-35%| I[卫星落袋一半]
    H --> J[④ 复盘与再平衡]
    I --> J
    J -->|每月:记录净值与分位| A
    J -->|季度:权重漂移±5%再平衡| A
    J -->|年度:整体审视更新方案| A

7. 压力情景预案

8. 附录

8.1 代码核验与纠错记录

以下代码均已核验真实存在；表中曾出现的 3 处错误已修正，下单前以本表为准：

8.2 数据口径与来源

基金代码、成立日期与规模均来自基金公司官网及证监会信息披露平台，核验时间 2026-10-08。主要来源：

• 易方达基金官网：022459 基金详情（成立 2024-11-11，规模 69.76 亿）
• 同花顺爱基金：159361 基金主页（成立 2024-11-12，份额 189.38 亿份）
• 证监会信披平台：天弘恒生科技ETF 联接（QDII）012348 基金详情（成立 2021-07-06）
• 证监会信披平台：银华中证创新药产业ETF 发起式联接 012781 基金详情（成立 2021-12-30）
• 天天基金：科创芯片ETF 南方 588890 详情（成立 2024-04-15，规模 47.54 亿）
• 嘉实基金：017469 基金详情
• 天天基金：红利低波ETF 华泰柏瑞 512890（成立 2018-12-19，规模 312.90 亿）
• 天天基金：007466 基金详情（成立 2019-07-15，规模 65.06 亿）
• 广发基金官网：513120 及联接 019670/019671 详情

估值分位（中证A500 约 20% 分位、恒生科技约 7% 分位等）为 2026-09-30 指数估值库口径；悲观回撤假设为历史极端回撤的近似下沿，属方案设计参数而非预测。本手册不构成收益承诺，市场有风险，投资需谨慎。