Markdown 常用语法教程

本教程按「基础知识介绍 + 举例」的方式编写。举例部分分为「写法」和「渲染效果」：写法用代码块展示源码，防止被编译；渲染效果展示编译后的样子，方便对照学习。

一、标题与段落

1. 六个级别的标题

# 的数量决定标题层级，从一级到六级：# 你的标题 为一级标题；## 你的标题 为二级标题，以此类推，最多支持六级。

例如（写法）：

# 你的标题
## 你的标题
### 你的标题
#### 你的标题
##### 你的标题
###### 你的标题

渲染效果：略

2. 段落与换行

普通回车不会换行：上一段和下一段之间必须空一行，才会被渲染成两个独立段落。想在同一段内强制换行，在行尾加两个空格，或者直接使用 <br> 标签。

例如（写法，行尾两个空格）：

这是第一行，空格空格   
这是第二行，

渲染效果：

这是第一行，行尾加了两个空格
这是第二行，仍在同一段内

例如（写法，<br> 标签）：

这是第一行<br>这是第二行

渲染效果：这是第一行
这是第二行

例如（写法，空行分段）：

这是第一个段落。

这是第二个段落。

渲染效果：这是第一个段落。

这是第二个段落。

二、文本强调

1. 粗体

用两个星号或两个下划线包裹文字：**文字** 或 __文字__。

写法：**这是粗体**，渲染效果：这是粗体。

2. 斜体

用一个星号或一个下划线包裹文字：*文字* 或 _文字_。

写法：*这是斜体*，渲染效果：这是斜体。

3. 粗斜体

用三个星号包裹文字：***文字***。

写法：***这是粗斜体***，渲染效果：这是粗斜体。

4. 删除线

用两个波浪号包裹文字：~~文字~~。

写法：~~这是删除线~~，渲染效果：~~这是删除线~~。

三、列表

1. 无序列表

行首用 -、* 或 + 加一个空格，即可创建无序列表。

例如（写法）：

- 苹果
- 香蕉
- 橙子

渲染效果：

苹果
香蕉
橙子

2. 有序列表

行首用「数字 + 点 + 空格」：1. 内容，数字会自动递增。

例如（写法）：

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

渲染效果：

第一步
第二步
第三步

3. 嵌套列表

子项在父项下缩进两个或四个空格，即可实现嵌套。

例如（写法）：

- 前端
  - HTML
  - CSS
    - Flexbox
    - Grid
- 后端

渲染效果：

前端
- HTML
- CSS
  - Flexbox
  - Grid
后端

4. 任务列表

用 - [ ] 表示未完成，- [x] 表示已完成。

例如（写法）：

- [x] 学习标题语法
- [x] 学习列表语法
- [ ] 学习表格语法

渲染效果：

学习标题语法
学习列表语法
学习表格语法

四、引用

1. 基本引用

行首加 > 加一个空格，即可创建引用块。

具体例子：写读书笔记时，引用书中的一段话——

例如（写法）：

> 读书不是为了雄辩和驳斥，也不是为了轻信和盲从，而是为了权衡和思考。
> —— 弗朗西斯·培根

渲染效果：

读书不是为了雄辩和驳斥，也不是为了轻信和盲从，而是为了权衡和思考。 —— 弗朗西斯·培根

再如：在项目文档中插入一条注意事项——

例如（写法）：

> 注意：上线前必须完成数据库备份，否则无法回滚。

渲染效果：

注意：上线前必须完成数据库备份，否则无法回滚。

2. 嵌套引用

连续使用多个 > 即可嵌套，常用于「对话层层引用」或「在引用中补充说明」。注意：内层引用前要用单独的 > 空一行，结构才清晰。

具体例子：记录一次技术讨论，小李引用小张的发言——

例如（写法）：

> 小张：这个接口建议用异步实现。
>
> > 小李：同意，同步会阻塞主线程。
>
> 结论：采用异步方案，下周一前提交代码。

渲染效果：

小张：这个接口建议用异步实现。

小李：同意，同步会阻塞主线程。

结论：采用异步方案，下周一前提交代码。

五、代码

1. 行内代码

用单个反引号包裹：`代码`。

例如（写法）：

在 Python 中用 `print("Hello")` 输出内容。

渲染效果：在 Python 中用 print("Hello") 输出内容。

2. 代码块

用三个反引号包裹多行代码，并在开头标注语言名，即可实现语法高亮。

例如（写法，外层四个反引号是为了展示内层三个反引号，写作时只需三个）：

```python
def greet(name):
    return f"你好，{name}！"

print(greet("Markdown"))
```

渲染效果：

def greet(name):
    return f"你好，{name}！"

print(greet("Markdown"))

常用语言标注：

标注	对应语言
`c`	C 语言
`cpp` / `c++`	C++
`csharp` / `cs`	C#
`python` / `py`	Python
`javascript` / `js`	JavaScript
`typescript` / `ts`	TypeScript
`java`	Java
`go`	Go
`rust`	Rust
`bash` / `sh` / `shell`	Shell 脚本
`sql`	SQL 数据库
`html` / `css`	网页标记 / 样式
`json` / `yaml`	数据与配置格式
`text` / `txt`	纯文本（无高亮）

六、链接与图片

1. 链接

写法为 [链接文字](网址)，网址后可以加空格和标题（鼠标悬停时显示）。

写法：[GitHub](https://github.com)，渲染效果：GitHub。

写法：[带标题的链接](https://github.com "访问 GitHub")，渲染效果：带标题的链接。

2. 图片

比链接多一个感叹号：![替代文字](图片地址)，方括号里写图片加载失败时显示的替代文字。

例如（写法）：

![示例图片](https://bu.dusays.com/2026/08/20/6a867d08f1815.jpg)

渲染效果：示例图片

七、表格

1. 基本表格

用 | 分隔单元格，第二行用 --- 分隔表头与表体。

例如（写法）：ヴァイオレット・エヴァーガーデン×十二単(8)

| 语法 | 作用 |
| ---- | ---- |
| `#` | 标题 |
| `**` | 粗体 |

渲染效果：

语法	作用
`#`	标题
`**`	粗体

2. 对齐方式

冒号控制对齐：:--- 左对齐、:---: 居中、---: 右对齐。

例如（写法）：ヴァイオレット・エヴァーガーデン×十二単(9)

| 左对齐 | 居中 | 右对齐 |
| :--- | :---: | ---: |
| 内容A | 内容B | 内容C |

渲染效果：

左对齐	居中	右对齐
内容A	内容B	内容C

八、分隔线

三个或以上的 -、* 或 _ 单独占一行，即可创建分隔线。

例如（写法）：

---

渲染效果：

九、转义与 HTML 兜底

1. 转义

在特殊符号前加反斜杠 \，即可让符号原样显示，如 \*、\#、\[。

写法：\*这不是斜体\*，渲染效果：*这不是斜体*。

2. HTML 兜底

Markdown 支持直接嵌入 HTML，排版不够用时可以用 HTML 标签兜底。

例如（写法）：

<kbd>Ctrl</kbd> + <kbd>S</kbd> 保存文件

渲染效果：

Ctrl + S 保存文件

十、总结

类别	关键符号
标题	`#`
强调	`*`、``、`~~`
列表	`-`、`1.`、`- [ ]`
引用	`>`
代码	反引号
链接 / 图片	`[文字](网址)`、`![文字](地址)`
表格	`\|` 和 `---`
分隔线	`---`

十一、Obsidian 特有写法

Obsidian 兼容标准 Markdown，并扩展了以下常用语法。Mermaid、公式等为 Obsidian 内置能力，无需额外插件。**以下「渲染效果」为 Obsidian 中的显示样式模拟与实际存在差异。

1. 双链（笔记间链接）

用双中括号包裹笔记名：[[笔记名]]，点击即可跳转到对应笔记，且自动生成反向链接（Obsidian 的核心特性）。

例如（写法）：

[[读书笔记]]
[[读书笔记|我的读书笔记]]   自定义显示文字
[[读书笔记#第二章]]        链接到指定标题

渲染效果（Obsidian 中为紫色可点击链接）：

读书笔记　（点击跳转，自动生成反向链接）

我的读书笔记　（显示自定义文字）

读书笔记 › 第二章　（定位到指定标题）

2. 嵌入与附件

在双链前加感叹号即可嵌入：笔记、标题、图片、PDF 都能直接嵌进当前页面。

例如（写法）：

![[读书笔记#第二章]]   嵌入指定章节
![[封面图.png]]        嵌入图片
![[合同.pdf]]          嵌入 PDF

渲染效果（Obsidian 中直接显示内容，图片会就地预览）：

封面图.png　（图片直接显示在此处）

3. 标签

行内写 #标签，支持层级：#学习、#项目/前端。

例如（写法）：

#学习 #读书

渲染效果（Obsidian 中显示为紫色标签）：略

4. 属性（Frontmatter）

文档开头用一对 --- 包裹元数据，定义标签、别名、日期等，Obsidian 属性面板可直接编辑。

例如（写法）：

---
title: 我的笔记
tags: [学习]
aliases: [别名A, 别名B]
created: 2026-08-20
---

渲染效果（Obsidian 以属性面板展示，可直接编辑）：

title　　我的笔记
tags　　学习
aliases　别名A、别名B
created　2026-08-20

5. 提示框（Callout）

引用块配合 [!类型]，类型前必须有感叹号，后面可自定义标题。

例如（写法）：

> [!tip] 小提示
> 记得每天备份！

> [!warning] 警告
> 该操作不可撤销！

渲染效果（Obsidian 中为彩色提示框）：

小提示
记得每天备份！

警告
该操作不可撤销！

常用类型：note、info、tip、success、question、warning、danger、quote。

6. 图表与公式

代码块标注 mermaid 可画流程图、时序图、甘特图等；数学公式用 $（行内）或 $$（块级）包裹。

例如（写法）：

```mermaid
graph LR
    A[开始] --> B{判断}
    B -->|是| C[完成]
    B -->|否| A
```

渲染效果（Obsidian 中显示为流程图）：

[开始] → {判断} → [完成]
　　　　　　　↳ 否 → 回到 [开始]

例如（写法）：

行内公式：$E = mc^2$
块级公式：$$ \int_0^1 x^2 \, dx = \frac{1}{3} $$

渲染效果：

行内公式：E = mc²　（按数学公式样式显示）

块级公式：∫₀¹ x² dx = ⅓　（独立成块显示）

7. 其他实用扩展

高亮：==重要内容== → 渲染效果：重要内容
注释：%%这里是注释%% → 渲染效果：阅读模式下完全不可见（仅编辑时显示）
脚注：正文写 文字[^1]，文末写 [^1]: 脚注内容 → 渲染效果：文字^[1]

[1] 脚注内容

兼容性提示：双链、标签、Callout 等是 Obsidian 专属语法，粘贴到 GitHub、微信公众号等平台不会按预期渲染，投稿前需转换。