Markdown语法笔记
序言
下述笔记为个人结合网上的相关参考资料总结的常用标准markdown语法笔记。
支持工具
-
记事本
-
Typora(编辑器,不具备管理功能)
-
Obsidian (编辑+管理)
-
Bear
-
Ulysses
-
石墨文档
-
幕布
常用语法
自动生成目录
[TOC]
部分软件不支持, 例如obsidian
标题
# 文本
关于标题:
# 一级标题, 一般是书籍的章标题或课程的章标题
## 二级标题, 一般是节内容
### 三级标题, 一般是重要知识点内容
四级以上的标题基本上不用, 用加粗或分割线代替, 最大支持六级标题
加粗
**文本**
斜体
*文本*
* 删除线
```markdown
~~文本~~
列表
(按tab按键缩进控制)
有序列表
1. 文本
2. 文本
无序列表
* 文本
* 文本
输入文本内容后,敲击 Enter 自动补全格式,并进入 下个 有序列表
若需要在同个列表内,增加 换行显示 的内容 (但不进入下个列表) 敲击 Shift + Enter ,即可另起一行输入文本
有序列表会强制按顺序显示, 若需要不严格按照顺序, 只能采用无序列表
引用(支持嵌入)
>文本
>~~文本嵌入~~
中间没有空格,同个引用段落内的换行直接敲击 Enter 即可, 若需添加 第二个独立引用段落 ,连续敲击 两下Enter 即可
引用的缩进&退格
- 引用的 缩进 和列表 不同
引用需另起一行,并额外多打一个 > 来完成 缩进 - 引用的 退格 与列表 相同
Shift + Tab
Ctrl + ] (右中括号)
Obsidian 中,如果想让已经缩进的引用 退回一层, 得使用
Shift
+ Enter
保持缩进空一个行,
配合方向键,
按enter
实现退回一层, 在多个 >
之间灵活断行 并在下一行 根据需要 选择性补充 >
的
的
的
的
链接
网页链接
[标题](链接)
例如:
[文件引用](./Database/文件.PDF) 其中 ./ 表示当前目录, ../表示上级目录, ../../表示上上级别的目录
[网页](https://www.bilibili.com/)
图像链接
图像格式:
通用:
![文字信息](图片链接 "提示文本信息")
特殊:
![[]]
图像格式,就是在网页链接前面加个 ! (英文格式的),! 代表 可见
图片的提示信息,和网页链接一样,写在 " " 内
[ ] 方括号里的文字信息在 Markdown 没啥实质的作用,只是方便在源代码模式下,知道这个图片是什么,在渲染界面是不会显示的。有点类似于HTML img标签 里的 alt属性。
![文字信息](图片链接 "提示文本信息")
![湘湖1](https://z3.ax1x.com/2021/08/06/fuNkXq.jpg "湘湖一角")
补充:
图像链接可以是本地的,也可以是在线的
本地图像直接 Ctrl + C 黏贴,Ctrl + V 复制 就可以
在线图像推荐使用 图床
调整图像的大小需要使用 HTML 和 CSS,在 Typora编辑器 中右键可以直接缩放图片 本质是转成了HTML的格式,最后会有一个 style="zoom: %;" ,这里数值可以自己修改
如果有使用 Obsidian 的朋友,在线图片链接是通用的。不过,因为 Obsidian 是双向链笔记 它的本地图片格式不太一样
![[图片名]]
Obsidian 中的图片是以双链的格式引用在目标笔记中,用 ! 使它可见
Obsidian的图片设置大小是用 | 分隔,后面写宽度数值,单位是px。 设定好宽度,高度会自动等比例调整
![[图片名|宽度数值]] - 若想自主调整图片宽高,则用: - ![[图片名|宽度数值x高度数值]] - #提示 这里的 x 是 英文字母x
如果是在线图床,需要调整图片大小:
![图床|宽度数值](链接地址)
代码域
行内代码
`代码`
如何在行内代码里显示反引号, 首尾各用 两个反引号`` +
空格` 包裹
代码块
```语言种类
代码内容
代码内容
代码内容
```
任务列表
- [ ] 文本
- [X] 含X表示代表事项已完成
在obsidian中, 第一次按下Ctrl+回车会创建一个无序列表, 再次按下ctrl+回车会变为任务列表
分界线
---
注释
Markdown 的 注释 和 HMTL 一样,注释的内容在 渲染界面 不可见 (部分编辑器可见)
注释 的格式:
<!-- 这里是注释的内容 -->
- 注释可以是单行,也可以是多行
如果有在使用 Obsidian 的,它的注释格式是不一样的
%%这是Obsidian的注释内容%%
表格
| 标题1 | 标题2 | 标题3 |
| ----- | ----- | ----- |
| 内容1 | 4 | 7 |
| 2 | 5 | 8 |
| 3 | 6 | 9 |
其中:
| :----- | ----- | ----- | 左对齐
| :-----: | ----- | ----- | 居中
| -----: | ----- | ----- | 右对齐
- Markdown的表格,比HTML简单很多
- | 是构成表格的主要 框架
- - 区分 表头 和 表格主体
- : 控制 表格内 文本内容 的 对齐方式
- Typora编辑器中 输入
Ctrl + T
即可快速插入表格,自由定义样式 - 表格中文本内容的换行, 可以在 中间 插入一个
<br>
( 换行标签 )
下划线
<u>这是一段加了下划线的文本</u>
缩进&退格
在列表和引用的书写过程中,我们需要利用 缩进 与 退格 ,让文章肌理分明,更具层级
缩进:
Tab
Ctrl+[
退格:
Shif+Tab
Ctrl+]
其它
<br> 换行
Ctrl+. 切换中英文标点
高阶用法
变量
网页链接变量
-
网页链接变量 的格式:
-
首先输入
-
[显示文本内容]
+[变量名]
- 变量名可以自己取,没啥限制,任意字符都可以
-
在文档任意一个区域,输入:
-
[变量名]
+ : + 空格 + 链接地址 (这个空格 不打也没事)
[百度一下,你就知道][度娘]
[知乎-有问题,就会有答案][知乎]
<!-- 这里是变量区域 -->
[度娘]: http://www.baidu.com
[知乎]: https://www.zhihu.com
示范
脚注
-
脚注 的格式:
-
在需要脚注的地方,输入:
-
[^脚注代号]
( 脚注代号会直接显示在渲染界面 )- 脚注代号可以随便命名,不过推荐使用 数字序号
-
在其他区域,输入:
-
[^脚注代号]
+ : + 空格 + 脚注内容 (这个 空格 不打也没事)
鲁迅原名是什么[^1] ,浙江哪里人[^2]
<!-- 这里是变量区域 -->
[^1]: 周树人
[^2]: 绍兴人
示范
拓展文本格式标记
- Markdown 想实现更多的文本显示效果,只能依赖HTML标记实现
- 个人不是很推荐在 MD 中使用 HTML,不过一些简单的标记还是可以 轻度使用 的
键盘文本
-
键盘文本的 格式:
-
<kbd>键盘文本</kbd>
-
<kbd>Ctrl</kbd> + <kbd>X</kbd>
-
效果:
键盘文本
-
Ctrl + X
-
说明:
键盘文本也不一定非得是键盘按键,也可以作为着重文本突出显示
-
- 效果: 这也算一种着重文本的方式
加粗键盘文本
-
加粗键盘文本的格式有两种:
-
<kbd>**键盘文本**</kbd>
**<kbd>ctrl + x</kbd>**
-
效果:
键盘文本
ctrl + x
放大文本
-
放大文本 的格式:
-
这是一段普通文本
<big>这是一段放大文本</big>
-
效果:
-
- 这是一段普通文本 这是一段放大文本
放大粗体文本
- 放大加粗文本的格式有两种:
**<big>这是一段放大粗体文本</big>**
<big>**这是一段放大粗体文本**</big>
- 效果:
这是一段放大粗体文本
这是一段放大粗体文本
缩小文本
-
缩小文本 的格式:
-
这是一段普通文本
<small>这是一段缩小文本</small>
-
效果:
这是一段普通文本 这是一段缩小文本
缩小斜体文本
- 斜体缩小文本 的格式有两种:
<small>*这是一段缩小斜体文本*</small>
*<small>这是一段缩小斜体文本</small>*
- 效果:
这是一段缩小斜体文本
多彩文本
多彩粗体文本
- 只需要在上面示例的基础上,加上 加粗标识符,有两种格式:
- 格式1:
**<font color=teal>这是一段加粗的水鸭色文本</font>**
- 效果: 这是一段加粗的水鸭色文本
- 格式2:
<font color=teal>**这是一段加粗的水鸭色文本**</font>
这是一段加粗的水鸭色文本
-
若上述混搭方法的样式失效 ,可以使用 纯HTML标记
-
- 格式:
<strong style="color:teal;">这是一段加粗的水鸭色文本</strong>
(标记略复杂,不是很推荐) - 效果:****这是一段加粗的水鸭色文本
- 格式:
多彩斜体文本
-
跟多彩加粗文本完全一样,只需把首尾的
**
换成*
即可 -
格式1:
*<font color=teal>This is an italic teal text</font>*
-
- 效果: *This is an italic teal text
-
格式2:
<font color=teal>*This is an italic teal text*</font>
-
- 效果: This is an italic teal text
多彩粗斜体文本
-
首尾换成
***
-
格式1:
***<font color=teal>This is a bold italic teal text</font>***
-
- 效果: This is a bold italic teal text
-
格式2:
<font color=teal>***This is a bold italic teal text***</font>
-
- 效果: This is a bold italic teal text
注意 多彩文本尽量慎用,Markdown 的核心就是 简洁精炼,注重 实质内容,而非花哨的 颜色样式
拓展文本显示效果
- 拓展显示效果既不是原生 Markdown语法 支持的,也非 HTML标记,而是部分编辑器 提供的 额外标识符,属于拓展语法,旨在为 Markdown使用者 提供更多样式选择
- 不同编辑器,支持不一样,这里以 Typora编辑器 为例
文本高亮
- 文本高亮 的格式:
==这里是一段高亮文本==
- 效果:
- 这里是一段高亮文本
上标
-
用一对 ^ 包裹 (Shift+ 6)
-
格式:
x^2^
-
效果: x2
-
Obsidian 没效果的,可以用后面会讲的 Latex
-
或者,也可以使用 HTML标记
-
<sup>这里是上标内容</sup>
X<sup>2</sup>
-
效果:
-
X2
12.3 下标
-
用一对 ~ 包裹 (Shift + `)
-
格式:
H~2~O
-
效果: H2O
-
Obsidian 没效果的,可以用后面会讲的 Latex
-
或者,也可以使用 HTML标记
-
<sub>这里是下标内容</sub>
H<sub>2</sub>O
-
效果:
-
- H2O
12.4 Emoji 符号
用一对 : 包裹,里面是 Emoji 符号的 语义化文本 ( Typora编辑器 中,输入 :
就会带提示器 )
-
示例:
-
:smile:
:sweat:
:cat:
:woman_cartwheeling:
-
效果:
-
- 😄 😓 🐱 🤸♀️
-
补充:
-
- 不支持上述方式的 MD编辑器或笔记软件,直接用 输入法 输入也是可以的
- Windows系统 用户 win + . 就可以输入 Emoji 了
- Obsidian 用户可以安装第三方插件来支持 Emoji 的输入,推荐两个
- Emoji Shortcodes
- Emoji Toolbar
转义字符
-
在 Markdown 中,我们 通过 标识符 改变 文本显示效果
-
现在我们希望它不作为标识符,而是 作为字符本身呈现出来 (不具备改变文本显示效果的功能,只是一个普通字符)
-
首先我们可以用前面介绍的 代码域 ,因为代码模式的显示效果就是源代码完全一致的
-
还有一种方法,可以利用转义字符,在这些标识符 前面 加上 反斜线**** ( 反斜线要紧贴在标识符前面,不能** 有 空格 )
-
-
原理:
-
\
的作用是让标识符 转义 变为一个普通字符,完成这个效果后,反斜线会自动隐藏 -
隐藏后的反斜线仅在源代码界面可见,在渲染界面不可见
-
反斜线只争对标识符起作用,其他字符添加
\
,\
不会自动隐藏 -
补充:
-
如果想给已经被加在标识符前面,会自动隐藏的
\
显示出来,可以在反斜线前面再加一个 * ,用它自己来转义自己* -
- 示例:****
这里紧跟在标识符前面的反斜线\\*会被转义成普通字符显示出来,不会自动隐藏,且这段文件会是斜体\*
- 效果: 这里紧跟在标识符前面的 反斜线*会被转义成普通字符显示出来,不会自动隐藏,且这段文件会是斜体*
- 示例:****
-
例1 以普通字符显示星号
-
如何让被一对或多对
\*
号 包裹的文本内容,能够正常显示\*
,且文本不改变格式 -
\*这段文本被一对星号包裹,但不会倾斜\*
- 效果: *这段文本被一对星号包裹,但不会倾斜*
\*\*这段文本被2对星号包裹,但不会加粗\*\*
- 效果: **这段文本被2对星号包裹,但不会加粗**
\*\*\*这段文本被3对星号包裹,但它既不倾斜也不加粗\*\*\*
- 效果: ***这段文本被3对星号包裹,但它既不倾斜也不加粗***
例2 表格内 单元格中的竖杠
- 在表格中,使用 | 作为单元格的内容,但不会被识别为表格的结构,不会增加额外的单元格
|表头1|表头2|
|-|-|
|这里的文本被\|分隔|这里的文本也被\|分隔|
- 效果:
表头1 | 表头2 |
---|---|
:------------------: | :--------------------: |
这里的文本被|分隔 | 这里的文本也被|分隔 |
补充 该技巧可用于 Obsidian 表格内 双链的文本修饰
文本修饰:
在 双链[[ ]]
内 以 |
引导的内容 - 格式: [[链接的内容|文本修饰]]
- 说明: 文本修饰是渲染界面实际显示的文本,便于更好地融入语境
表格内的格式:
在 |
前面加上 \
- [[表格内的链接内容\|文本修饰]]
示例:
| 表头1 | 表头2 |
|:---------------------------------------:|:---------------------------------------------------:|
| [[#例2 表格内 单元格中的竖杠\|单元格中的竖杠]] | [[#例3 不会变成代码的反引号\|不会变成代码的反引号]] |
效果:
| 表头1 | 表头2 | |:---------------------------------------😐:---------------------------------------------------😐 | [[#例2 表格内 单元格中的竖杠|单元格中的竖杠]] | [[#例3 不会变成代码的反引号|不会变成代码的反引号]] |
例3 不会变成代码的反引号
使用 转义符号\
让 反引号``` 变成普通字符,不再具有[[#7 1 行内代码|行内代码]]的标识符功能
格式:
\
这段被反引号包裹的内容不会变成行内代码``
效果:
这段被反引号包裹的内容不会变成行内代码
例4 链接中的中括号
在 网页链接 的 显示文本内容 中,使用 中括号 [ ]
- 在显示文本内容中,在其中一个中括号前面,加上转义符号 反斜杠 **
- 格式:****
[链接里的 \[中括号\] 能被正常显示](https://www.runoob.com)
- 效果:[链接里的 中括号] 能被正常显示
例5 不是列表的连接符(横杠)
- 引用一段话,一般会在换行之后,加上
- 出处
- 因为 - 是标识符,会变成一个无序列表
如下所示:
The Web, the Tree, and the String. 写作之难,在于把网状的思考,用树状结构,体现在线性展开的语句里。 - 史蒂芬·平克
- 解决方法:
- 在 - 前面加上 转义符号 **
```md
The Web, the Tree, and the String. 写作之难,在于把网状的思考,用树状结构,体现在线性展开的语句里。 - 史蒂芬·平克 ```
- 效果:
The Web, the Tree, and the String. 写作之难,在于把网状的思考,用树状结构,体现在线性展开的语句里。 - 史蒂芬·平克
例6 不是标题的 \
让 #
不被识别为标题标识符
格式:
\# 这里的内容不会被识别为标题
效果:
# 这里的内容不会被识别为标题
例7 不会注释的 %
在 Obsidian 中 注释是前后各两个 %
号
使用 转义符号\
,让 %%
作为普通字符显示出来,不具备注释的功能
- 格式:
\%\%这里的内容可以被显示喔\%\%
- 效果: %%这里的内容可以被显示喔%%
例8 木有链接的双链
Obsidian 的双向链格式是2个方括号 [[ ]]
(双方),使用 转义符号\
,让 [
]
不再具有 双链功能
格式:
\[\[这段文本被双方包裹,但不是一个双向链\]\]
效果:
[[这段文本被双方包裹,但不是一个双向链]]
例9 页链接里 显示文本内的 中括号
使用转义符号\
,让中括号
可以作为显示文本
在[[#5 1 网页链接|网页链接]]中显示出来
格式:
[\[这是一个带中括号的网页链接显示文本,点击会跳转至百度\]](https://www.baidu.com/)
效果:
特殊情况 文本修饰的中括号
文本修饰的 中括号[ ]
不需要使用 转义符号\
示范:
[[#例8 木有链接的双链|[这是一个带中括号的文本修饰]]]
效果:
[[#例8 木有链接的双链|[这是一个带中括号的文本修饰]]]
空格&换行&强制删除
空格
-
在一些编辑器或者支持MD的笔记软件里,无论你打多少个空格,它只会显示单个 空格 的距离
-
可以使用 HTML中 空格 的 字符实体 ——
-
若要添加 多个 空格,就输入多个 ——
-
格式:
这里有 6个空格分隔
-
效果:
这里有 6个空格分隔
换行
场景1: - 在一些编辑器或者支持MD的笔记软件里,无论你打多少个 回车,它只会显示单个 回车 的空行间距 - 可以使用之前表格里提到的 <br>
标签,在 单独一行 中使用,增加额外的空行间距 - 如果要增加 多个,就输入 多个 —— <br><br><br><br><br>
- #注意 当单独一行使用 <br>
标签的时候,如果前后有标题标识符或者列表标识符,确保 br元素 前后两行都是空白行
格式:
这里是第一段文本
<br><br><br><br><br> <!-- 这里插入了5个空行间距 -->
这里是第二段文本
效果:
这里是第一段文本
这里是第二段文本
场景2: - 在列表中也可以插入换行符
- 这是一段无序列表
<br> <!-- 插入一个空行间距,需单独一行,上下不用预留空格 -->
这是同一段无序列表中,空一行距离显示的内容
- 这是第二段无序列表
效果:
-
这是一段无序列表
这是同一段无序列表中,空一行距离显示的内容 -
这是第二段无序列表
-
补充:
-
有一些MD编辑器或笔记软件,严格遵循MD的换行规则,你敲一个回车是没法换行的,必须在 行末 敲 2个空格,再按回车键
-
- 格式:
- 这里是一段想换行的文本空格 空格 Enter 这是换行后的文本
强制删除
-
很多编辑器都有英文标点自动补全功能,自动生成一对,光标落在中间 只想删除前面1个,却会把 一整对 都删掉
-
在多个列表的嵌套中,也许会遇到一些 无法被删除 的 列表标识符
-
解决方法: 使用
Shift
+Backspace
即可强制删除 -
- Bcakspace ( 退格键 )
嵌入
- 嵌入都是依赖 HTML标签 实现的,嵌入的都是在线链接格式
-
- 如果是本地的,Obsidian 中音频是有自带的可录制的录音机插件的,其他的 音频、视频 直接复制黏贴就可以了,也可以直接拖拽到OB的笔记界面
-
- 其他的媒体文件在 Obsidian 也和图片一样,以双链的格式引用在目标笔记中,使用 ! 使它可见
嵌入音频
格式:
<audio controls="controls" preload="none" src="音频链接地址"></audio>
示例:
嵌入视频
- 格式:
<video width="600" height="420" controls>
<source src="movie.mp4" type="video/mp4">
<source src="movie.ogg" type="video/ogg">
<source src="movie.webm" type="video/webm">
</video>
- 说明:
- width ( 宽度 ) height ( 高度 ) ,可以自己设置,直接输入数字即可,单位默认是 px(像素) 也可以使用 百分比****
width=100%
代表水平撑满整个窗口height=50%
代表垂直撑满半个窗口 - Video标签 支持的视频格式 :MP4 ogg webm
嵌入页面
-
格式:
<iframe width=600 height=400 src="页面链接地址" scrolling="auto" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>
-
效果:
- iframe标签 除了嵌入页面,也可以嵌入在线视频,主流的视频网站都会提供嵌入代码
- 具体可以看这个 iframe视频嵌入教程
- B站 的视频,得在
//
前面补充http:
- 不是所有的 编辑器和笔记软件 都支持这个
- 示例:
<iframe width=600 height=400 src="http://player.bilibili.com/player.html?aid=20190823&bvid=BV1yW411s7og&cid=32964980&page=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>
-
宽高设置和前面的 video 一样
-
效果:
Latex 数学公式
主要用于 数学公式 与 化学公式 的书写
行内公式
-
格式:
-
$ + 行内公式 + $
-
示例:
$x^2 + 2x + 5 + \sqrt x = 0$
$\ce{CO2 + C -> 2 CO}$
-
$\ce{CO2 + C -> 2 CO}$
-
$\ce{2Mg + O2 ->[燃烧] 2 MgO}$
-
效果:
-
- $x^2 + 2x + 5 + \sqrt x = 0$
- $e^{i\pi} + 1 = 0$
- $\ce{CO2 + C -> 2 CO}$
- $\ce{2Mg + O2 ->[燃烧] 2 MgO}$
公式块
-
格式:
-
$$
公式块$$
-
示例:
% 化学公式
$$
\ce{Zn^2+ <=>[+ 2OH-][+ 2H+] $\underset{\text{amphoteres Hydroxid}}{\ce{Zn(OH)2 v}}$ <=>[+ 2OH-][+ 2H+] $\underset{\text{Hydroxozikat}}{\ce{[Zn(OH)4]^2-}}$}
$$
% 麦克斯韦方程组
$$
\begin{array}{lll}
\nabla\times E &=& -\;\frac{\partial{B}}{\partial{t}}
\ \nabla\times H &=& \frac{\partial{D}}{\partial{t}}+J
\ \nabla\cdot D &=& \rho
\ \nabla\cdot B &=& 0
\ \end{array}
$$
% 薛定谔方程
$$
i\hbar\frac{\partial \psi}{\partial t} = \frac{-\hbar^2}{2m} \left(\frac{\partial^2}{\partial x^2} + \frac{\partial^2}{\partial y^2}+\frac{\partial^2}{\partial z^2} \right) \psi + V \psi
$$
% 化学公式
$$
\ce{Zn^2+ <=>[+ 2OH-][+ 2H+] $\underset{\text{amphoteres Hydroxid}}{\ce{Zn(OH)2 v}}$ <=>[+ 2OH-][+ 2H+] $\underset{\text{Hydroxozikat}}{\ce{[Zn(OH)4]^2-}}$}
$$
% 麦克斯韦方程组
$$
\begin{array}{lll}
\nabla\times E &=& -;\frac{\partial{B}}{\partial{t}}
\ \nabla\times H &=& \frac{\partial{D}}{\partial{t}}+J
\ \nabla\cdot D &=& \rho
\ \nabla\cdot B &=& 0
\ \end{array}
$$
% 薛定谔方程
$$
i\hbar\frac{\partial \psi}{\partial t} = \frac{-\hbar^2}{2m} \left(\frac{\partial^2}{\partial x^2} + \frac{\partial^2}{\partial y2}+\frac{\partial2}{\partial z^2} \right) \psi + V \psi
$$
- 补充:
- 需要详细教程的,可戳下方链接
- Latex详细教程
Mermaid
- 一些 MD编辑器 和 笔记软件 支持通过 Mermaid 及其所提供的 编译器 来为用户提供图表的绘制功能
- 这里只提供一些演示的图表,具体教程可戳下方
- [[MOC Mermiad 教程 Obsidian版| Mermiad 超级教程 Obsidian版]]
绘制流程图
源码1:
渲染1:
graph TB
%% s=start e=end f=fork n=normal
s([开始])-->f1{{if条件}};
%% 分支点1
f1--true-->n1[if语句块]-->e([结束]);
f1--false-->f2{{else if条件}};
%% 分支点2
f2--true-->n2[else if语句块]-->e;
f2--false-->n3[else语句块]-->e;
渲染2:
绘制饼图
序列图 (时序图)
甘特图
类图
特殊语法
obsidian
双链
- [[Obsidian教程#双链|双链]]
![[文章名称#^具体位置|别名]]
模板占位符
- [[Obsidian教程#占位符|模板占位符]]
{{title}}
{{date}}
{{date:YYYY-MM-DD_dd}}
{{time}}
{{time:HH:mm}}
标签 (Tag)
- 标签是 Obsidian 特有的一个功能,标签可以通过点击唤起快速搜索 (搜索包含该标签的所有笔记)
格式: - # + 标签名 - #标签名
关于空格
-
在一段正文文本的后面添加 Tag, # 的前面 需要有个空格
-
- 空格 + # + 标签名
-
# 与 标签名 之间,不能有空格,否则就变成 一级标题 了
-
标签名的内部,不允许使用空格,若想区分标签中的词语,可使用以下三种方法:
- 驼峰式大小写:
#BlueTopaz
- 下划线:
#blue_topaz
- 连字符:
#blue-topaz
关于数字
-
标签内允许使用数字,但不能完全由数字组成
-
#1984
❌#1984Date
⭕#da_1984_te
⭕#date-1984
⭕
标签的嵌套
在标签名内,使用 /
斜杠 可以实现标签的嵌套
格式: - #主标签/子标签1
- #主标签/子标签2
- #主标签/子标签3
嵌套标签可以像普通标签一样通过点击来唤起搜索,嵌套标签允许你选择搜索的层次。例如: - 搜索 #主标签
,即可找到包含任意一个子标签的所有笔记 - 返回的结果会是上述的三个例子 - 当你在一个主分类下设置了多个子分类,想找到这个主分类包含的所有内容时,该功能会很实用
能被使用的符号
综上所述,标签内能被使用的符号共有三种
_
下划线-
连字符/
斜杠
如何让 # 不被识别
可以使用前面提到的转义符号 \
反斜杠,与上述的 转义标题 类似
格式:
\#这里的内容不会被识别为标签
效果:
#这里的内容不会被识别为标签
注意
避免标识符的滥用
即使在 Markdown 中,也要尽量避免标识符的滥用
标识符的本质是突出显示,代表重点 - 一篇笔记里的某段文本,使用各式各样的的标识符,会造成重点不清晰
有三种标识,慎用!
- 词中对单个汉字的标识 1. 卧虎藏龙
- 短语中对单个英语单词的标识 1. get a bang out of
- 标识符的多层嵌套 1. 我感觉快要原地
起飞
了
原因: - 词义的割裂 - 视觉的混乱 - 不利于搜索 - 卧==虎==藏==龙==
- 搜 卧虎
-- 搜不到 - 搜 藏龙
-- 搜不到
其它
-
在段落之间应该空一行, 为了确保兼容性
AAAAAAAAAAAAAAAAA段落一 BBBBBBBBB段落二 CCCCCCCCCCCC段落三
-
Obsidian 在列表首行使用缩进的时候,后续的列表会出现一些问题
Tab
和Shift + tab
会无法 缩进 退格- 可以使用
Ctrl + ]
与Ctrl + [
来解决问题
- - 这是第一段就被缩进的列表
- 这是第二段被再次缩进的列表 <!-- 这里需按两次 Ctrl + ] ,Tab键是无效的 -->
- 这是第三段列表 <!-- Ctrl + [ -->
本文来自博客园,作者:舟清颺,转载请注明原文链接:https://www.cnblogs.com/zqingyang/p/18125322