标题

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

文字修饰

这里是一段斜体文本
这也是一段斜体文本

这里是一段加粗文本
这也是一段加粗文本

粗斜体文本 1
粗斜体文本 2
粗斜体文本 3
粗斜体文本 4
粗斜体文本 5
粗斜体文本 6

这里是一段斜体中包含粗体的文字
这也是一段斜体中包含粗体的文字
这又是一段斜体中包含粗体的文字
这还是一段斜体中包含粗体的文字

这里是一段粗体中包含斜体的文字
这也是一段粗体中包含斜体的文字
这又是一段粗体中包含斜体的文字
这还是一段粗体中包含斜体的文字

高亮文本

这里是一段高亮文本

水平线,删除线,下划线

下面是一条水平分割线:



这是一段加了删除线的文本

这是一段加了下划线的文本

图片和超级链接

链接的加粗,格式有两种:

markdown示例教程-20240222054705709.webp

图像格式
markdown示例教程-20240222055100273.webp

markdown示例教程-20240222055224041.webp

调整嵌入的图片大小

你可以通过以下语法调整嵌入到笔记中的图片的大小:

Markdown 风格的嵌入,使用 ![AltText|100x100](https://url/to/image.png) 这样的语法。

一般的嵌入,使用 ![[image.png|100x100]] 这样的语法。

如果要根据图像的宽高比例进行缩放,请省略高度,如 ![[image.png|100]]

内部链接

两个[[]]表示内部链接地址,图片预览可以在[前加!,图片大小可以加修饰符|xxx
在预览模式下,如果想在新面板中打开链接,则需按住 Ctrl/Cmd 再点击内部链接
在编辑模式下,按住 Ctrl/Cmd 点击内部链接即可在当前面板打开链接
在编辑模式下,如果想在新面板中打开链接,则需按住 Ctrl/Cmd+Shift 再点击内部链接
这些规则外部链接也通用。

说明:
这个语法实际受到了 Markdown 相关语法的启发:

  1. 在 Markdown 中,[Image](link.png) 可以让链接指向图片,而 ![Image](link.png) 能让图片嵌入到当前文档中。
  2. 内部链接的语法则基于以下设定:[[My page]] 是 [My page](My page) 的一个便捷写法(或者是“语法糖”)。

综上,我们可以得到 ![[My page]] 应该等效于 ![My page](My page)

普通链接
todo

图片
image.png-1.webp

嵌入文件参见
嵌入 pdf

URLs and Email Addresses 参考

To quickly turn a URL or email address into a link, enclose it in angle brackets.

<https://www.markdownguide.org>
<fake@example.com>

Linking Images 参考

To add a link to an image, enclose the Markdown for the image in brackets, and then add the link in parentheses.

[![An old rock](/assets/images/shiprock.jpg "Shiprock, New Mexic")](https://www.flickr.com/photos/)

块链接与块引用

什么是块

一个块可以是一个段落、一个引用、一个列表等等。一般来说,前后有空行包围的东西就是块 。

链接某个笔记文件中的块,你首先需要输入 [[文件名 来唤起弹窗,在选择相应的文件后,通过输入 ^ 进入块选择界面。随后,你需要继续输入关键词来选择你所需要链接的块。

块链接

选择好了以后,按下回车键,对于该块的链接就创建好了。块链接会以 [[filename#^dcf64c]] 的形式出现,其中 dcf64c 则是你所链接的块的 ID。

如果你忘了想链接的块在哪个文件里,你可以通过输入 [[^^ 在库的所有笔记文件中查找该块。由于这种查找方式涉及库中所有笔记文件,当你的库很大时,查找就需要花费一些时间。

比如:^2865ca 可以连接到前文的段落 (点击链接试试)。

块引用

嵌入文件一样,你可以通过在块链接前加上 ! 来进行块引用,即块的嵌入。

比如下面这段话就是引用前面的段落(修改前面的段落,引用会自动修改):

一个块可以是一个段落、一个引用、一个列表等等。一般来说,前后有空行包围的东西就是块 。

手动创建块 ID

如果你想手动创建可读性强的块 ID,你可以在块的末尾手动加上 ^你的-id 这样的语法。需要注意的是,对于一般的段落,手动创建的 ID 和块最后一个字符(即段落最后一个字符)间需要有一个或多个空格。

如果想为表格这样比较复杂的块手动创建 ID,你需要将手动创建的 ID 放置在该块之后,同时确保手动创建的块 ID 前后都是空行。

比如:


| header1 | header2 |
| ------- | ------- |
| 1       | 2       |

^TableDemo
header1 header2
1 2
header1 header2
1 2

当你手动创建了块 ID 后再链接或引用该块时,TableDemo 会自动使用你手动创建的块 ID 而不是随机生成的块 ID。

需要注意的是,手动创建的块 ID 仅支持字母、数字、破折号。

迁移性

请注意,块链接和块引用并非 Markdown 的标准语法,而是带有 Obsidian 风格的 Markdown 语法。这意味着这些链接和引用将在其他软件中失效。

不过,尽管如此,只要你的软件支持文件内容的全局搜索,你还是可以通过搜索块 ID 来查找链接或引用的块。块链接与块引用本身包含的链接信息是不会丢失的,只不过你想在其他软件中利用它们会麻烦一点。

别名链接

有时,一则笔记可能在不同语境中有不同的名字。这就是我们所说的“别名”。

设置笔记的别名

从 0.9.16 开始,你可以在笔记的 YAML front matter 中设置笔记的别名。例如:

---
aliases: [AI, Artificial Intelligence]
---

请注意,Front matter 需要放在笔记开头才能生效。同时,aliases 需要使用英文。

未来,官方会考虑采取更友好的方式来让用户使用、管理别名,而不是让用户手动在笔记的 Front matter 中输入。

链接到别名

一旦你为笔记设置了别名,你就可以通过 [[别名]] 的方式来引用这篇具有多个名称的笔记。引用时,对话框中会显示重定向标志,如下图所示:

markdown示例教程-20240224012340635.webp

按下回车后,插入的链接会这样显示:[[笔记原名称|别名]]

可以发现,Obsidian 并没有直接以 [[别名]] 的方式插入链接,而是用别名对原标题进行了修饰,这样别的软件也能轻松识别你链接了别名的笔记。

提到当前标题

当你为某一笔记设置别名后,其他笔记无论是提到当前笔记的原标题还是别名,都会在 提到当前标题 中显示。

比如,当你为一篇名为“人工智能”的笔记设置了“AI”这个别名后,你就可以在反向链接中找到其他提到了“AI”的笔记,从而将“人工智能”这篇笔记与这些笔记链接起来。当你点击 转为内部链接 按钮后,这些笔记中的“AI”就会被替换为 [[人工智能|AI]] 这样的链接。

Obsidian URI 链接

Obsidian URI 可以让你在其他应用或 Obsidian 的其他库中打开当前库的某篇笔记。

比如,你可以通过以下方式跳转到某个库中的某篇笔记(请注意 URI 的编码):

[打开某篇笔记](obsidian://open?path=D:%2Fpath%2Fto%2Ffile.md)

除了通过笔记的地址来链接笔记外,你也可以通过笔记所在的库名称以及笔记名称来链接该笔记:

[打开某篇笔记](obsidian://open?vault=MainVault&file=MyNote.md)

网页链接变量和脚注

(选中查看源码)

脚注:(预览视图下查看效果,选中查看源码)

鲁迅原名是什么[1] ,浙江哪里人[2]

列表和缩进

列表

  1. 这是第一个有序列表

  2. 这是第二个有序列表

  3. 这是第三个有序列表

  4. 这是第一个有序列表
    这是同个列表下,另起一行的文本内容

  5. 这是第二个有序列表
    这是同个列表下,另起一行的文本内容

    1. 这是无序列表下,整十数排列的内容
    1. 这是无序列表下,整十数排列的内容
    1. 这是无序列表下,整十数排列的内容
    1. 这是无序列表下,整百数排列的内容
    1. 这是无序列表下,整百数排列的内容
    1. 这是无序列表下,整百数排列的内容
  • 这是第 1 个无序列表

  • 这是第 2 个无序列表

  • 这是第 3 个无序列表

  • 这是第一个无序列表
    这是同个列表下,另起一行的文本内容

  • 这是第二个无序列表
    这是同个列表下,另起一行的文本内容

这是第一段引用文本的第 1 行
这是第一段引用文本的第 2 行

这是第二段引用文本的第 1 行
这是第二段引用文本内第 2 行

缩进

Tab
Ctrl + [ (左中括号)

退格:
Shift + Tab
Ctrl + ] (右中括号)

混排

  1. 第一级有序列表 1
    1. 第二级有序列表 1
    2. 第二级有序列表 2
  2. 第一级有序列表 2

补充说明:有序列表的数字序号,即便你在源代码模式里强行改掉数字,它仍然会依照顺序显示

  • 第一级无序列表 1
    • 第二级无序列表 1
    • 第二级无序列表 2
  • 第一级无序列表 2

这是第一级引用

这是第二级引用

这里又是第一级引用了

  1. 第一级有序列表 1
    • 第二级无序列表 1

      第三级引用 1

      - 第四级无序列表 2 <!-- (Shift + Enter) -->
        	1. 第五级有序列表 2 <!-- (Enter) -->
        - 第四级无序列表 3   <!-- 写文本前,先( Shift + Tab 或 Ctrl + [ ) ;写完后再 (Enter) -->
      

      第三级引用 2

    • 第二级无序列表 4
  2. 第一级有序列表 3

Obsidian 的一些缩退问题
Obsidian 在列表首行使用缩进的时候,后续的列表会出现一些问题
Tab 和 Shift + tab 会无法缩进退格
可以使用 Ctrl + ] 与 Ctrl + [ 来解决问题

如:

    • 这是第一段就被缩进的列表
    • 这是第二段被再次缩进的列表
    • 这是第三段列表

任务列表

(选中看源码)

  • 待办任务列表 1
  • 待办任务列表 2
  • 已办任务列表 1
  • 已办任务列表 2

markdown示例教程-20240222061203197.webp

表格

| 是构成表格的主要框架
-区分表头和表格主体
: 控制表格内文本内容的对齐方式

|这里是表头 1|这里是表头 2|这里是表头 3|
|:-|:-:|-:|
|单元格数据 1|单元格数据 2|单元格数据 3|
|单元格数据 4|单元格数据 5|单元格数据 6|

示范:

这里是表头 1 这里是表头 2 这里是表头 3
单元格数据 1 单元格数据 2 单元格数据 3
单元格数据 4 单元格数据 5 单元格数据 6

表格中文本内容的换行:
markdown示例教程-20240222060129635.webp

代码域

这是一段行内代码

<table border="1" cellspacing="0" width="500" height="500">

print("Hello, World!")

这是一行突出显示的文本内容

代码内容
代码内容
代码内容

代码块的嵌套

```js
// 3. 输出 100以内(不包括100) 所有偶数的和
// 这类求和问题的核心 : 利用循环  (总和 = 旧数的和 + 新数)

let sum = 0;

for (let i = 1, sum = 0; i < 100; i++) {
 if (i % 2 == 0) {
 // 筛选偶数
 sum += i; // sum = sum + i // 累加偶数并赋值给sum
 // sum为(旧的,已经进入循环的数)的和,i 为新进入循环的数。当加到(最后一个新数i)时,sum就是最后的 总和
 }
}

console.log(sum); // 打印总和
```

在行内代码里显示反引号

这是一段能显示`反引号`的行内代码

注释

markdown 和 HTML 混用

如下:(选中查看源码)

This is a bold italic teal text

转义

转义字符,显示*号

*这段文本被一对星号包裹,但不会倾斜*

**这段文本被 2 对星号包裹,但不会加粗**

***这段文本被 3 对星号包裹,但它既不倾斜也不加粗***

如果 url 中含有空格的话,空格需要转义为 %20,如:

[Export options](Pasted%20image)

当然,你也可以用 <> 将空格包含起来,如:

[Slides Demo](<Slides Demo>)

表格中用 |转义|

表头 1 表头 2
这里的文本被|分隔 这里的文本也被|分隔

`这段被反引号包裹的内容不会变成行内代码`

转义链接内的文本修饰
文本修饰

在网页链接的显示文本内容中转义括号 [ ]

其他转义

- 史蒂芬·平克

# 这里的内容不会被识别为标题

%%这里的内容可不被注释喔%%

[[这段文本不是一个双向链]]

文本修饰的中括号[ ] 不需要使用转义符号
[这是一个带中括号的文本修饰]

强制删除

很多编辑器都有英文标点自动补全功能,自动生成一对,光标落在中间,只想删除前面 1 个,却会把一整对都删掉
解决办法就是:Shift + Backspace 即可强制删除

嵌入网页与多媒体

嵌入音频

(选中查看源码)

嵌入视频

(选中查看源码)

Width ( 宽度 ) height ( 高度 ) ,可以自己设置,直接输入数字即可,单位默认是 px (像素)
也可以使用百分比
Width=100% 代表水平撑满整个窗口
Height=50% 代表垂直撑满半个窗口
Video 标签支持的视频格式 :MP 4 ogg webm

嵌入页面

(选中查看源码)

嵌入 pdf

例如:

![[My File.pdf#page=number]]

目前为止,Obsidian 支持以下格式的文件:

  1. Markdown 文件:md;
  2. 图像文件:pngjpgjpeggifbmpsvg;
  3. 音频文件:mp3webmwavm4aogg3gpflac;
  4. 视频文件:mp4webmogv;
  5. PDF 文件:pdf.

Callouts 语法

可以使用插件 Admonitions 快速输入
markdown示例教程-20240222071044291.webp
markdown示例教程-20240222071103144.webp

markdown示例教程-20240222071137558.webp

注意:不要忘记 > 与 [
] 与标题间有空格

标题

内容

这是一个 callout 标题

这里是 callout 里的内容
callout 内部支持双链

  • 同样支持MD 语法
这是一个可折叠的标题

这里的内容可通过点击 Callouts 标题 折叠起来

在后面加上 - 减号,默认处于折叠状态 [!note]-

Callouts 类别
默认共支持 12 种类别 (可自己在 Admonitions 插件里添加)

Note
Abstract, summary, tldr
Info, todo
Tip, hint, important
Success, check, done
Question, help, faq
Warning, caution, attention
Failure, fail, missing
Danger, error
Bug
Example
Quote, cite

这是一个 bug 类别

这里是内容

Callouts 支持多层嵌套

这是第一层

这里是第一层的内容

这是嵌套的第二层

这里是第二层的内容

支持用 CSS 来自定义类型和图标,不过我个人没怎么用

Mermaid

流程图

true
false
true
false
开始
if条件
if语句块
结束
else if条件
else if语句块
else语句块
长子
次子
三子
四子
长子
次子
长子
朱百六
朱四九
朱五四
朱八八
朱标
朱樉
朱棢
朱棣
朱雄英
朱允炆
朱高炽

饼图

70%13%10%6%为什么总是宅在家里?关你屁事天气太热喜欢宅

甘特图

2014-01-052014-01-122014-01-192014-01-262014-02-022014-02-092014-02-16A task Task in sec another task Another task SectionAnotherA Gantt Diagram

类图

Animal
+int age
+String gender
+isMammal()
+mate()
Duck
+String beakColor
+swim()
+quack()
Fish
-int sizeInFeet
-canEat()
Zebra
+bool is_wild
+run()

Latex 数学公式

行内公式

格式:$ + 行内公式 + $




公式块

格式:

% 化学公式

% 麦克斯韦方程组

% 薛定谔方程