前置知识
阅读本文前,建议先了解:
- 01-Markdown 的定义与作用 - 了解 Markdown 基本概念
一、标题语法
用 # 号表示标题,共支持 1-6 级:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题渲染效果:
一级标题
二级标题
三级标题
[!技巧] 建议
- 一级标题(
#)用于文章大标题- 二级标题(
##)用于章节划分- 三级及以下用于小节
二、段落与换行
2.1 段落
段落之间用空行分隔:
这是第一段。
这是第二段。2.2 换行
行末输入两个以上空格 + 回车,或者使用 <br>:
这是第一行(行末有空格)
这是第二行
这是<br>使用HTML标签换行三、文本格式
| 语法 | 效果 | 说明 |
|---|---|---|
**粗体** | 粗体 | 两侧各两个星号 |
*斜体* | 斜体 | 两侧各一个星号 |
~~删除线~~ | 两侧各两个波浪线 | |
`行内代码` | 行内代码 | 两侧各一个反引号 |
四、列表
4.1 无序列表
使用 -、+ 或 *:
- 第一项
- 第二项
- 子项(缩进2-4个空格)
- 第三项渲染效果:
- 第一项
- 第二项
- 子项
- 第三项
4.2 有序列表
使用数字 + .:
1. 第一步
2. 第二步
3. 第三步渲染效果:
- 第一步
- 第二步
- 第三步
4.3 任务列表
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个待办渲染效果:
- 已完成任务
- 未完成任务
- 另一个待办
五、链接与图片
5.1 链接
[显示文本](https://example.com)
[内部链接]([[01-什么是Markdown]])5.2 图片
[!技巧] Obsidian 技巧 在 Obsidian 中,可以使用以下方式嵌入本地图片:
![[图片文件名.png]]
六、代码块
6.1 行内代码
使用反引号 ` 包裹:
这是 `代码` 示例6.2 代码块
使用三个反引号 ``` 包裹,并可指定语言:
```python
def hello():
print("Hello, World!")
return 0
```渲染效果:
def hello():
print("Hello, World!")
return 0[!重点] 为什么代码块重要? 代码块能完美保留代码的缩进和格式,对于技术文档和 AI 交互至关重要。
七、引用
使用 > 符号:
> 这是一段引用
> 可以换行继续
> > 嵌套引用渲染效果:
这是一段引用 可以换行继续
嵌套引用
八、分割线
使用三个或更多的 -、*、_:
---渲染效果:
九、表格
| 表头1 | 表头2 | 表头3 |
|-------|-------|-------|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |渲染效果:
| 表头1 | 表头2 | 表头3 |
|---|---|---|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
[!技巧] 表格技巧
|:---|左对齐|:---:|居中|---:|右对齐
十、Obsidian 特有语法
Obsidian 在标准 Markdown 基础上扩展了一些强大功能:
10.1 Wiki 链接
[[其他笔记]]
[[其他笔记|显示文本]]10.2 Callout(提示块)
> [!note] 标题
>
> 内容
> [!tip] 提示
>
> 这是一个提示
> [!warning] 警告
>
> 这是一个警告渲染效果:
标题
内容
提示
这是一个提示
警告
这是一个警告
10.3 属性(YAML Frontmatter)
笔记开头的元数据:
---
title: 笔记标题
date: 2026-03-18
tags: [tag1, tag2]
status: completed
---十一、常用场景速查表
| 需求 | 语法 |
|---|---|
| 加粗 | **文本** |
| 斜体 | *文本* |
| 删除线 | ~~文本~~ |
| 代码 | `代码` |
| 代码块 | ``` 语言 |
| 链接 | [文本](url) |
| 标题 | # 标题 |
| 无序列表 | - 项 |
| 有序列表 | 1. 项 |
| 引用 | > 引用 |
| 分割线 | --- |
| 表格 | | 列 | |
| 任务列表 | - [ ] 项 |
十二、总结
- Markdown 语法只有 约 10 种常用元素
- 学几分钟就能上手,写几次就能熟练
- Obsidian 扩展语法(Wiki 链接、Callout)让笔记更强大
一句话:用最少的语法,做最多的事。
十三、延伸阅读
- 01-Markdown 的定义与作用 - Markdown 基本概念
- 03-Markdown 的核心优势 - 为什么选择 Markdown
- 04-Markdown 与 LLM - 与 AI 协作的最佳语言