前置知识

阅读本文前,建议先了解:


一、标题语法

# 号表示标题,共支持 1-6 级:

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

渲染效果:

一级标题

二级标题

三级标题

[!技巧] 建议

  • 一级标题(#)用于文章大标题
  • 二级标题(##)用于章节划分
  • 三级及以下用于小节

二、段落与换行

2.1 段落

段落之间用空行分隔:

这是第一段。
 
这是第二段。

2.2 换行

行末输入两个以上空格 + 回车,或者使用 <br>

这是第一行(行末有空格)
这是第二行
 
这是<br>使用HTML标签换行

三、文本格式

语法效果说明
**粗体**粗体两侧各两个星号
*斜体*斜体两侧各一个星号
~~删除线~~删除线两侧各两个波浪线
`行内代码`行内代码两侧各一个反引号

四、列表

4.1 无序列表

使用 -+*

- 第一项
- 第二项
  - 子项(缩进2-4个空格)
- 第三项

渲染效果:

  • 第一项
  • 第二项
    • 子项
  • 第三项

4.2 有序列表

使用数字 + .

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

渲染效果:

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

4.3 任务列表

- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个待办

渲染效果:

  • 已完成任务
  • 未完成任务
  • 另一个待办

五、链接与图片

5.1 链接

[显示文本](https://example.com)
[内部链接]([[01-什么是Markdown]])

5.2 图片

![图片描述](image-url.png)

[!技巧] 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)让笔记更强大

一句话:用最少的语法,做最多的事


十三、延伸阅读