Obsidian 是基于markdown语法编辑器的笔记软件,记笔记之前,我们要先学习一下markdown基本语法,以便快速、简便的记录笔记。
markdown 是一种轻量级的标记语言,排版语法简洁,让人们更多地关注内容本身而非排版,可用于在纯文本文档中添加格式化元素。
1. 标题语法
使用井号(#)开头,加一个空格,后接内容,就创建了一个标题,# 的数量代表了标贴的级别。
语法:
# h1 一级标题
## h2 二级标题
### h3 三级标题
#### h4 四级标题
##### h5 五级标题
###### h6 六级标题
2. 段落语法
obsidian 的编辑器设置里,有一个严格换行的选项,默认是未开启状态,此时编辑文本时,敲回车键一次就是换行,敲两次是分段,即使用空白行将一行或多行文本进行分隔,从而创建段落。
开启严格换行功能后,根据 markdown 标准,单个换行符在预览模式下不再生效。
提示
假如笔记内容需要复制到其他软件的 markdown 编辑器中>>进行编辑,建议开启严格换行功能,保持内容格式在其他 markdown 编辑器里不变。
3. 换行语法
在 markdown 中换行,有一些方法,因为各家的 markdown 编辑器不同,所有也会有不同的呈现,以下为在 obsidian 开启开启严格换行功能后的换行方式;
在当前行的结尾加 2 个空格
使用反斜杠\ + 一个回车换行
使用HTML代码换行
4. 强调语法
语法:
*斜体*
_斜体_
**粗体**
__粗体__
`内联代码`
~~删除~~
==高亮==
文本样式:
5. 引用语法
> 这是一个
> 块引用
>
> > 嵌套
> > 块引用
阅读效果:
提示
这是一个块引用
提示
嵌套块引用
6. 列表语法
无序列表1,使用星号(*)+ 空格
* list1
* list2
* list 2.1
* list 2.2
阅读效果:
list1
list2
list 2.1
list 2.2
无序列表2,使用减号(-)+ 空格
- list1
- list2
- list 2.1
- list 2.2
阅读效果:
list1
list2
list 2.1
list 2.2
无序列表3,使用加号(+)+ 空格
+ list1
+ list2
+ list 2.1
+ list 2.2
阅读效果:
list1
list2
list 2.1
list 2.2
以上三种无序列表语法,最终显示结果是一样的,根据自身喜好人选其一就行。
有序列表(点的后面有空格)
1. Item 1
2. Item 2
阅读效果:
Item 1
Item 2
任务列表
- [ ] 任务1
- [x] 任务2
阅读效果:
[ ] 任务1
[x] 任务2
7. 代码块语法
代码块:用成对的3个反引号包裹代码内容,右上角标注语言的名称是为了给代码着色。
行内代码:用成对的反引号,在一行内包裹代码,类似markdown这样的。
```javascript
代码正文
```
阅读效果:
代码正文
8. 链接语法
外部链接语法:
阅读效果:
obsidian官网
obsidian内部链接语法:
[[内部链接]]
html链接:
9. 表格语法
基础表格语法:
| 左栏 | 中间栏 | 右栏 |
| ------- | ------- | ------- |
| 单元格 1 | 单元格 3 | 单元格 5 |
| 单元格 2 | 单元格 4 | 单元格 6 |
阅读效果:
改变文字对齐方式:
左栏 | 中间栏 | 右栏
:------- | :------: | -----:
左对齐 | 居中 | 右对齐
阅读效果:
10. 图片语法
基础图片语法:
参考风格:
在基础图片语法的图片链接后面,加上控制语法,可以控制图片的居中方式和尺寸大小。
图片居中和左右对齐
设置图片尺寸
建议在obsidian中,使用内链的方式嵌入图片!
obsidian中的图片语法
在 obsidian 中,会有一些特殊的语法。比如内链的图片格式中。
对上面图片设置居中,阅读效果会显示图片的名称;
在代码的最后加一个|,就会不显示文件名了;
11. 脚注语法
在 Markdown 中使用[^锚点文字]来定义脚注。
在之后的任何位置使用[^锚点文字]: ...来描述脚注内容。
#1.定义脚注
脚注 1 链接[^one]
脚注 2 链接[^two]
#2.描述脚注的内容(在脚注之后任意位置定义都可以)
[^one]: 脚注里也支持 **markdown语法**
[^two]: 我是脚注2的文字。
阅读效果:
12. 分割线语法
三个或三个以上的 ‘-’ 或 ‘*’ 都可以 格式如下:
***
---
阅读效果:
***分割线1
---分割线2
13. callout标注块语法
callout 标注块是 obsidian 新增的格式,也被称为admonitions警告表现形式是带颜色的块引用,有标题、背景颜色和icon图标, 它极大的丰富了 obsidian 的排版,增加了美观度。
在别的markdown编辑器中也有类似的样式,但语法稍有不同。以下callout标注块语法均为obsidian中的。
语法:
> [!info] 自定义标题
> 包裹的内容
> 可以是多行的内容
在标题部分可以使用-和+符号,让callout面板折叠或者展开,比如:
可折叠
> [!info]+ 这是一个可折叠的callout
> 包裹的内容,注意上面的+号
被折叠
> [!info]- 这是一个被折叠的callout
> 包裹的内容,注意上面的-号
默认的
> [!info] 默认的callout
> 包裹的内
callout可以有很多的样式,替换[!info]中的名称:
Note
Abstract
Info
Todo
Tip
Success
Question
Warning
Failure
Danger
Bug
Example
Quote
阅读效果:
领取专属 10元无门槛券
私享最新 技术干货