Obsidian 基本格式语法
段落
在 Markdown 中创建段落，需使用空行来分隔文本块。每个由空行分隔的文本块都被视为独立的段落。
这是一个段落
这是另一个段落
文本行之间的空行会创建独立的段落。这是 Markdown 的默认行为。
换行
在 Obsidian 中，默认情况下按一次 Enter 会在笔记中创建新行，但在渲染输出中，这被视为同一段落的_延续_，这遵循了典型的 Markdown 行为。要在段落_内_插入换行而不开始新段落，你可以：
- 在按
Enter之前在行末添加两个空格，或者 - 使用快捷键
Shift+Enter直接插入换行
严格换行
为什么多次按 Enter 不会在阅读视图中产生更多换行？
Obsidian 包含一个严格换行设置，使 Obsidian 遵循标准 Markdown 规范处理换行。
启用方法：
- 打开设置
- 转到编辑器选项卡
- 启用严格换行
启用严格换行后，换行会根据行的分隔方式产生三种不同的行为：
| 行为 | 语法 | 渲染效果 |
|---|---|---|
| 单次回车且无尾随空格 | line one + Enter + line two |
两行合并为一行 |
| 单次回车且有两个或更多尾随空格 | line one + Enter + line two |
同一段落，但用换行符分隔 |
| 双次回车（无论是否有尾随空格） | 按两次或更多次 Enter |
分为两个独立段落 |
标题
要创建标题，在标题文本前添加最多六个 # 符号。# 符号的数量决定标题的级别。
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
加粗、斜体、高亮
| 样式 | 语法 | 示例 | 输出 |
|---|---|---|---|
| 加粗 | ** ** 或 __ __ |
**加粗文本** |
加粗文本 |
| 斜体 | * * 或 _ _ |
*斜体文本* |
斜体文本 |
| 删除线 | ~~ ~~ |
~~删除线文本~~ |
|
| 加粗和嵌套斜体 | ** ** 和 _ _ |
**加粗文本和_嵌套斜体_文本** |
**加粗文本和_嵌套斜体_文本** |
| 加粗和斜体 | *** *** 或 ___ ___ |
***加粗和斜体文本*** |
***加粗和斜体文本*** |
可以通过在格式符号前添加反斜杠 \ 来强制以纯文本显示：
\**这行不会被加粗**
\*_这行会是斜体并显示星号_
内部链接
Obsidian 支持两种笔记间内部链接的格式：
- Wiki 链接：
[[牛顿运动三定律]] - Markdown：
[牛顿运动三定律](牛顿运动三定律.md)
外部链接
如果你想链接到外部 URL，可以用方括号（[ ]）包围链接文本，然后用圆括号（( )）包围 URL 来创建内联链接。
[Obsidian 帮助](https://help.obsidian.md)
[笔记](obsidian://open?vault=MainVault&file=Note.md)
转义链接中的空格
如果你的 URL 包含空格，必须将空格替换为 %20 来转义它们：
[我的笔记](obsidian://open?vault=MainVault&file=My%20Note.md)
你也可以用尖括号（< >）包裹 URL 来转义：
[我的笔记](<obsidian://open?vault=MainVault&file=My Note.md>)
外部图片
你可以通过在外部链接前添加 ! 符号来添加外部 URL 的图片。
调整图片尺寸： 在链接目标中添加 |宽度x高度：
如果只指定宽度，图片会按原始宽高比缩放：
引用
你可以在文本前添加 > 符号来引用文本。
> 人类面临着越来越复杂和紧迫的问题，他们在处理这些问题方面的有效性对社会的稳定和持续进步至关重要。
\- Doug Engelbart, 1961
列表
无序列表
在文本前添加 -、* 或 + 来创建无序列表：
- 第一个列表项
- 第二个列表项
- 第三个列表项
有序列表
每行以数字开头，后跟 . 或 ) 符号：
1. 第一个列表项
2. 第二个列表项
3. 第三个列表项
使用 Shift+Enter 可以在有序列表中插入换行而不改变编号。
任务列表
每个列表项以连字符和空格后跟 [ ] 开头：
- [x] 这是一个已完成的任务
- [ ] 这是一个未完成的任务
你可以在阅读视图中通过选中复选框来切换任务状态。
嵌套列表
你可以将任何类型的列表嵌套在其他列表下。要创建嵌套列表，请缩进一个或多个列表项：
1. 第一个列表项
1. 有序嵌套列表项
2. 第二个列表项
- 无序嵌套列表项
- [ ] 任务项 1
- [ ] 子任务 1
- [ ] 任务项 2
- [ ] 子任务 1
使用 Tab 或 Shift+Tab 来缩进或减少缩进选中的列表项。
分隔线
使用三个或更多的星号 ***、连字符 --- 或下划线 ___ 单独占一行来添加水平分隔线：
***
---
___
代码
行内代码
使用单个反引号在句子中格式化行内代码：
行中 `反引号` 内的文本将被格式化为代码。
如果想在行内代码中放置反引号，可以用双反引号包围：
行内 ``包含反引号 ` 的代码``
代码块
用三个或更多反引号（或波浪号）包围代码：
```js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
```
Obsidian 使用 Prism 进行语法高亮，支持多种语言。
嵌套代码块
当需要在一个代码块中包含另一个代码块时，为外层代码块使用更多的反引号或波浪号：
````md
以下是如何创建代码块：
```js
console.log("Hello world")
```
脚注
这是一个简单的脚注[^1]。
[^1]: 这是引用的文本。
[^2]: 在每个新行的开头添加 2 个空格。
这样你就可以编写跨多行的脚注。
[^note]: 命名脚注仍然显示为数字，但可以更容易地识别和链接引用。
你也可以在句子中使用行内脚注（插入符号位于方括号外面）：
这是行内脚注^[这是脚注内容]
注释
用 %% 包裹文本来添加注释，注释仅在编辑模式中可见：
这是一个 %%行内%% 注释。
%%
这是一个块注释。
块注释可以跨多行。
%%
转义 Markdown 语法
要按字面意思显示特殊字符，请在它们前面放置反斜杠（\）：
| 字符 | 转义语法 |
|---|---|
| 星号 | \* |
| 下划线 | \_ |
| 井号 | \# |
| 反引号 | \` |
| 管道符 | | |
| 波浪号 | \~ |
在使用有序列表时，转义数字后面的句点以防止自动列表格式化：
1984\. 这是一个很棒的年份。
了解更多
要了解更多高级格式语法，如表格、图表和数学表达式，请参阅 [[高级格式语法]]。