Markdown 语法
标题
使用 # 符号创建标题，# 的数量表示标题级别：
markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题标题最佳实践
- 每篇笔记建议只有一个一级标题
- 从二级开始使用子标题
- 标题层级不要跳跃（如从二级直接跳到四级）
段落和换行
- 段落之间使用空行分隔
- 行尾加两个空格或使用
<br>换行
markdown
这是第一段
这是第二段
这是第一行
这是第二行强调
markdown
**粗体文本**
__粗体文本__
*斜体文本*
_斜体文本_
***粗斜体文本***
___粗斜体文本___
~~删除线~~
==高亮文本==高亮语法
==高亮== 是 Obsidian 特有的语法，标准 Markdown 不支持。可以用于标记重点内容。
列表
无序列表
markdown
- 项目 1
- 项目 2
- 子项目 2.1
- 子项目 2.2
- 项目 3
* 或者使用星号
+ 或者使用加号有序列表
markdown
1. 项目 1
2. 项目 2
1. 子项目 2.1
2. 子项目 2.2
3. 项目 3任务列表
markdown
- [x] 已完成的任务
- [ ] 未完成的任务
- [ ] 另一个任务任务列表可以点击切换状态，非常适合任务管理和待办事项追踪。
定义列表
markdown
术语 1
: 定义 1
术语 2
: 定义 2a
: 定义 2b链接
外部链接
markdown
[链接文本](https://example.com)
[链接文本](https://example.com "鼠标悬停提示")
<https://example.com>
<email@example.com>内部链接（Obsidian 特有）
markdown
[[笔记名称]]
[[笔记名称|自定义显示文本]]
[[笔记名称#标题|跳转到特定标题]]
[[笔记名称^block-id|跳转到特定块]]嵌入链接
使用 ! 前缀可以嵌入内容：
markdown
![[笔记名称]] <!-- 嵌入整篇笔记 -->
![[笔记名称#标题]] <!-- 嵌入特定章节 -->
![[笔记名称^block-id]] <!-- 嵌入特定块 -->块引用
要创建块 ID，在段落后添加 ^block-id，例如：
markdown
这是一个重要的段落 ^important-para然后可以用 [[笔记名^important-para]] 引用它。
图片
markdown
![[图片名称.png]]
![[图片名称.png|宽度x高度]]
![[图片名称.png|300]] <!-- 只指定宽度 -->图片对齐
使用 HTML 控制图片对齐：
markdown
<div align="center">
<img src="image.png" width="400">
<p>图片说明</p>
</div>代码
行内代码
markdown
使用 `code` 表示行内代码代码块
markdown
```javascript
function hello() {
console.log('Hello, Obsidian!');
}
```支持的语言
Obsidian 支持语法高亮的语言包括：
| 类别 | 语言 |
|---|---|
| 编程语言 | javascript, typescript, python, java, cpp, c, go, rust, ruby, php |
| 前端 | html, css, scss, less, vue, jsx, tsx |
| 数据格式 | json, yaml, xml, toml |
| 脚本 | bash, shell, powershell, batch |
| 数据库 | sql |
| 文档 | markdown, latex |
| 其他 | dockerfile, makefile, diff |
代码块高级功能
markdown
```javascript:hello.js
// 文件名显示
function hello() {
return "Hello";
}
```
```markdown {1-2} hl:3
# 高亮第3行
第一行
第二行
第三行被高亮
```引用
markdown
> 这是一段引用
>
> > 嵌套引用
> **注意**：重要提示内容
>
> 引用中的段落表格
基本表格
markdown
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |对齐方式
markdown
| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| 内容 | 内容 | 内容 |复杂表格
对于复杂表格，可以使用 HTML：
markdown
<table>
<tr>
<th>标题1</th>
<th>标题2</th>
</tr>
<tr>
<td rowspan="2">跨行单元格</td>
<td>内容</td>
</tr>
<tr>
<td>内容</td>
</tr>
</table>分隔线
markdown
---
***
___三种写法效果相同，建议在分隔线前后各留一个空行。
脚注
markdown
这是一个脚注[^1]，这是另一个脚注[^note]
[^1]: 这是脚注的内容
[^note]: 这是带命名脚注的内容，可以放在文档任意位置脚注内容可以放在文档的任意位置，通常放在文档末尾。
数学公式
Obsidian 使用 MathJax 渲染 LaTeX 数学公式。
行内公式
markdown
这是一个行内公式 $E = mc^2$，质能方程。块级公式
markdown
$$
\frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$常用公式示例
分数与根号
markdown
$\frac{a}{b}$ <!-- 分数 -->
$\sqrt{x}$ <!-- 平方根 -->
$\sqrt[n]{x}$ <!-- n次方根 -->上下标
markdown
$x^2$ <!-- 上标 -->
$x_i$ <!-- 下标 -->
$x_i^2$ <!-- 同时使用 -->
$_nC_r$ <!-- 前置下标 -->求和与积分
markdown
$\sum_{i=1}^{n} x_i$ <!-- 求和 -->
$\prod_{i=1}^{n} x_i$ <!-- 连乘 -->
$\int_{a}^{b} f(x)dx$ <!-- 积分 -->
$\iint_{D} f(x,y)dxdy$ <!-- 二重积分 -->矩阵
markdown
$$
\begin{bmatrix}
a & b \\
c & d
\end{bmatrix}
$$方程组
markdown
$$
\begin{cases}
x + y = 1 \\
x - y = 0
\end{cases}
$$希腊字母
| 小写 | 代码 | 大写 | 代码 |
|---|---|---|---|
| α | \alpha | Α | A |
| β | \beta | Β | B |
| γ | \gamma | Γ | \Gamma |
| δ | \delta | Δ | \Delta |
| θ | \theta | Θ | \Theta |
| λ | \lambda | Λ | \Lambda |
| μ | \mu | - | - |
| π | \pi | Π | \Pi |
| σ | \sigma | Σ | \Sigma |
| φ | \phi | Φ | \Phi |
| ω | \omega | Ω | \Omega |
Mermaid 图表
Obsidian 支持 Mermaid 语法绘制各种图表。
流程图
markdown
```mermaid
graph TD
A[开始] --> B{判断}
B -->|是| C[处理]
B -->|否| D[结束]
C --> D
```流程图方向
| 符号 | 方向 |
|---|---|
TB | 从上到下 |
BT | 从下到上 |
LR | 从左到右 |
RL | 从右到左 |
节点形状
mermaid
graph LR
A[矩形] --> B(圆角矩形)
B --> C((圆形))
C --> D{菱形}
D --> E[[子程序]]
E --> F[(数据库)]连接线样式
mermaid
graph LR
A --> B <!-- 实线箭头 -->
C --- D <!-- 实线无箭头 -->
E -.-> F <!-- 虚线箭头 -->
G ==> H <!-- 粗线箭头 -->
I --文字--> J <!-- 带文字 -->时序图
markdown
```mermaid
sequenceDiagram
participant A as 用户
participant B as 系统
A->>B: 发送请求
B-->>A: 返回响应
Note over A,B: 这是一个说明
```时序图语法
| 语法 | 说明 |
|---|---|
->> | 实线箭头 |
-->> | 虚线箭头 |
-) | 异步消息 |
--x | 失败消息 |
Note over | 跨参与者说明 |
甘特图
markdown
```mermaid
gantt
title 项目计划
dateFormat YYYY-MM-DD
section 阶段1
任务1 :a1, 2024-01-01, 30d
任务2 :after a1, 20d
section 阶段2
任务3 :2024-02-01, 25d
任务4 :2024-02-10, 15d
```类图
markdown
```mermaid
classDiagram
class Animal {
+String name
+int age
+makeSound()
}
class Dog {
+String breed
+bark()
}
Animal <|-- Dog
```状态图
markdown
```mermaid
stateDiagram-v2
[*] --> 待处理
待处理 --> 处理中
处理中 --> 已完成
处理中 --> 已取消
已完成 --> [*]
已取消 --> [*]
```饼图
markdown
```mermaid
pie showData
title 时间分配
"工作" : 40
"学习" : 25
"娱乐" : 20
"休息" : 15
```思维导图
markdown
```mermaid
mindmap
root((中心主题))
分支1
子分支1-1
子分支1-2
分支2
子分支2-1
子分支2-2
```Callouts（标注框）
Callouts 是 Obsidian 特有的功能，用于创建醒目的标注框。
基本语法
markdown
> [!note] 标题
> 这是 note 类型的 callout 内容
> [!tip] 标题
> 这是 tip 类型的 callout 内容Callout 类型
| 类型 | 用途 | 图标 |
|---|---|---|
note | 默认备注 | 📝 |
abstract / summary | 摘要总结 | 📋 |
info | 信息提示 | ℹ️ |
todo | 待办事项 | ✅ |
tip / hint | 提示技巧 | 💡 |
success / check | 成功标记 | ✅ |
question / help | 问题求助 | ❓ |
warning / caution | 警告注意 | ⚠️ |
failure / fail / missing | 失败错误 | ❌ |
danger / error | 危险警告 | ⚡ |
bug | Bug 记录 | 🐛 |
example | 示例代码 | 📝 |
quote | 引用内容 | 💬 |
可折叠 Callout
markdown
> [!note]- 点击展开
> 默认折叠的内容
> 可以包含多行
> [!note]+ 点击折叠
> 默认展开的内容嵌套 Callout
markdown
> [!note] 外层标题
> 外层内容
> > [!tip] 内层标题
> > 内层内容HTML 标签
Markdown 中可以直接使用 HTML：
文本样式
markdown
<div style="color: red;">
红色文本
</div>
<span style="font-size: 20px; font-weight: bold;">大号加粗文本</span>
<mark>标记高亮</mark>
<kbd>Ctrl</kbd> + <kbd>C</kbd>折叠内容
markdown
<details>
<summary>点击展开</summary>
隐藏的内容在这里，可以包含 Markdown 格式。
</details>居中内容
markdown
<center>
居中的内容
</center>注释
markdown
<!-- 这是注释，不会在预览中显示 -->
<!--
多行注释
可以跨越多行
-->转义字符
使用反斜杠转义特殊字符：
markdown
\* 不是斜体 \*
\# 不是标题
\[ 不是链接
\` 不是代码快速参考表
常用语法速查
| 语法 | 效果 |
|---|---|
**粗体** | 粗体 |
*斜体* | 斜体 |
~~删除线~~ | |
==高亮== | ==高亮== |
^上标^ | 上标 |
~下标~ | 下标 |
[链接](url) | 超链接 |
[[内部链接]] | 内部链接 |
 | 图片 |
`代码` | 行内代码 |
快捷键速查
| 操作 | Windows/Linux | macOS |
|---|---|---|
| 粗体 | Ctrl+B | Cmd+B |
| 斜体 | Ctrl+I | Cmd+I |
| 插入链接 | Ctrl+K | Cmd+K |
| 代码块 | Ctrl+` | Cmd+` |