夜雨聆风
Obsidian MD文档教程
Obsidian Markdown 使用教程
概述
Markdown 是一种轻量级标记语言，专为简单易读易写的纯文本格式设计。在 Obsidian 中，Markdown 是创建和组织知识的核心工具。本教程将介绍 Markdown 基础语法和 Obsidian 特有功能。
Markdown 基础语法
1. 标题
使用 # 符号创建标题，# 的数量表示标题级别（1-6级）：
- 1
- 2
- 3
- 4
- 5
- 6
# 一级标题## 二级标题### 三级标题#### 四级标题##### 五级标题###### 六级标题
2. 段落和换行
- 段落：用空行分隔
- 换行：在行尾添加两个空格，然后回车
3. 文本样式
- 1
- 2
- 3
- 4
- 5
**粗体文本** 或 __粗体文本__*斜体文本* 或 _斜体文本_***粗斜体文本***~~删除线文本~~==高亮文本==
4. 列表
无序列表
使用 -、* 或 +：
- 1
- 2
- 3
- 4
- 项目一- 项目二- 子项目- 子项目
有序列表
使用数字加点号：
- 1
- 2
- 3
- 4
1. 第一项2. 第二项1. 子项一2. 子项二
任务列表
- 1
- 2
- [ ] 待办任务- [x] 已完成任务
5. 链接和图片
外部链接
- 1
- 2
[链接文本](https://example.com)[带标题的链接](https://example.com "标题")
图片
- 1
- 2
6. 引用
使用 > 创建引用：
- 1
- 2
- 3
- 4
> 这是一个引用>> 可以多行> > 嵌套引用
7. 代码
行内代码
使用反引号 `：
- 1
使用 `print("Hello")` 函数代码块
使用三个反引号，可指定语言：
- 1
- 2
- 3
- 4
```pythondef hello():print("Hello World")```
8. 分隔线
使用三个或更多 -、* 或 _：
- 1
- 2
- 3
---***___
9. 表格
- 1
- 2
- 3
- 4
| 标题1 | 标题2 | 标题3 ||-------|-------|-------|| 内容1 | 内容2 | 内容3 || 内容4 | 内容5 | 内容6 |
对齐方式：
- 1
- 2
- 3
| 左对齐 | 居中对齐 | 右对齐 ||:-------|:--------:|-------:|| 单元格 | 单元格 | 单元格 |
Obsidian 特有功能
1. 内部链接（WikiLinks）
Obsidian 使用双括号创建内部链接：
- 1
- 2
- 3
[[笔记名称]][[文件夹/笔记名称]][[笔记名称|显示文本]]
2. 嵌入内容
嵌入其他笔记或文件：
- 1
- 2
- 3
<img src="笔记名称" alt="笔记名称" /><img src="图片.png" alt="图片.png" /><img src="视频.mp4" alt="视频.mp4" />
3. 标签
使用 # 创建标签：
- 1
- 2
#标签#项目/子标签
4. 元数据（Frontmatter）
在文件开头使用 YAML 格式添加元数据：
- 1
- 2
- 3
- 4
- 5
- 6
---title: 笔记标题date: 2026-03-03tags: [教程, markdown, obsidian]aliases: [别名1, 别名2]---
5. 标注块（Callouts）
使用 > [!类型] 创建标注块：
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
> [!note] 注意> 这是一个注意标注块> [!tip] 提示> 这是一个提示标注块> [!warning] 警告> 这是一个警告标注块> [!info] 信息> 这是一个信息标注块
支持的标注类型：note、tip、warning、danger、info、success、question、failure、bug、example、quote、abstract、summary、tldr、todo、faq、help、caution、error、attention、cite
6. 脚注
- 1
- 2
- 3
这是一个带脚注的句子[^1]。[^1]: 这是脚注内容。
7. 数学公式
使用 LaTeX 语法：
- 1
- 2
- 3
- 4
- 5
- 6
行内公式：$E = mc^2$块公式：$$\sum_{i=1}^{n} i = \frac{n(n+1)}{2}$$
8. 注释
使用 %% 添加注释（在预览时隐藏）：
- 1
这是可见文本 %%这是注释，预览时不可见%%9. 高亮文本
使用 == 高亮文本：
- 1
这是 ==高亮文本==10. Dataview 查询
使用代码块查询笔记：
- 1
- 2
- 3
- 4
- 5
```dataviewLIST FROM #标签WHERE file.ctime > date(2026-01-01)SORT file.name ASC```
11. Mermaid 图表
创建流程图、时序图等：
- 1
- 2
- 3
- 4
- 5
- 6
- 7
```mermaidgraph TDA[开始] --> B{判断}B -->|是| C[执行]B -->|否| D[结束]C --> D```
实用技巧
1. 快速创建笔记
- 输入
[[新笔记名称]]并点击创建 - 使用命令面板（Ctrl/Cmd + P）
2. 快速格式化
- 选中文本使用快捷键：
- Ctrl/Cmd + B：粗体
- Ctrl/Cmd + I：斜体
- Ctrl/Cmd + K：链接
3. 文件管理
- 使用文件夹组织笔记
- 创建模板文件（在 .obsidian/templates 中设置）
- 使用星标收藏重要笔记
4. 搜索技巧
- 使用
tag:#标签搜索标签 - 使用
path:"文件夹"搜索路径 - 使用
-搜索词排除内容
5. 插件推荐
- Dataview：高级查询和数据分析
- Templater：强大的模板功能
- QuickAdd：快速添加内容
- Calendar：日历视图
- Excalidraw：手绘风格绘图
常用快捷键
通用快捷键
Ctrl/Cmd + N：新建笔记Ctrl/Cmd + O：打开笔记Ctrl/Cmd + S：保存Ctrl/Cmd + F：在当前笔记中搜索Ctrl/Cmd + Shift + F：在所有笔记中搜索
编辑快捷键
Ctrl/Cmd + B：粗体Ctrl/Cmd + I：斜体Ctrl/Cmd + K：链接Ctrl/Cmd + ]：增加缩进Ctrl/Cmd + [：减少缩进
视图快捷键
Ctrl/Cmd + E：切换编辑/预览模式Ctrl/Cmd + Shift + E：切换实时预览
最佳实践
1. 命名规范
- 使用有意义的文件名
- 避免特殊字符
- 使用连字符而不是空格
2. 组织结构
- 创建清晰的文件夹结构
- 使用标签进行跨文件夹分类
- 定期整理和归档
3. 链接策略
- 创建双向链接
- 使用 MOC（内容地图）组织相关笔记
- 避免过度链接
4. 备份策略
- 定期备份 vault
- 使用 Git 进行版本控制
- 同步到云存储
注：本文章由Obsidian+AI自动发布。
