Typecho的后台文章编辑器支持Markdown，作为第一篇，先放一份Markdown教程在这里，也方便自己日后参考时避免再到处去找。
转发自“yikelee 成雙醬”。
（貌似Obsidian中使用的Markdown语法在这里不能100%兼容，但总比没有强吧。）
MarkDown语法 超详细教程
MD语法教程，适合新手入门，也适合老手瞅瞅
初稿写了一周左右，前前后后又修改了一个多月
应该是比较完善了
Mermaid ，iframe ， Latex 部分 在论坛里显示有问题
可以去 网页发布版 或 MD源文件 获得最佳阅读体验
本教程有发布publish上
Markdown 超级教程by成雙醬 8.9k
需要原 MD文档 和 PDF 的，可以戳下面的网盘链接
百度网盘：
链接：https://pan.baidu.com/s/13ZoKSRZkqQc_JuxK3AGFmA 10.3k
提取码：tqp8
阿里云盘：
链接：https://www.aliyundrive.com/s/eooT6xPzLhh 4.8k
以下是教程内容
什么是 Markdown?
- Markdown 是一款轻量级标记语言，不同于HTML (Hypertext Markup Language)，Markdown 的语法非常简单，且容易上手
- Markdown 以 纯文本格式 编写文档，依赖键盘而非鼠标，专注于写作本身，感受书写的魅力
- Markdown 的通过添加一些简单的 标识符，让文本具有恰到好处的格式
- Markdown 核心特征就是 删繁剪芜， 简扼 + 精炼
- Markdown 是 笔记 与 网页文章 的最佳载体
Down 的核心：坐 下 来，就能把思维写 下 来
- 牛津高阶英汉双解词典第九版 中，关于 down 的释义：
为什么要使用 Markdown?
有朋友问我 ，Markdown 的效果 用Word 完全可以复现，甚至功能更多，那为何要用 Markdown 呢？
答：
功能多，不一定是好事
功能一多，选择就会变多，然后你会开始纠结……
- 这个字号是不是该大一点呢？
- 这个颜色好像有点不太搭呢？
- 这个粗体，是不是该再加点颜色呢？
- 这个图片的位置看起来有点不大对劲呢？
结果，写了半天，就憋出一点点东西
MD的优势：
- Markdown 让我们免于 被繁杂臃肿的功能晃花了眼 的困扰
- Markdown 让我们回归内容本身，拥抱笔记的内核，而非浮于表象的样式，写出高效精练的笔记！
用 Markdown 写东西，记住一个原则
能用10个字搞定的，绝不用11个字
经常使用 Markdown 书写的朋友，也许会有一种奇妙的感触
关于标识符的滥用
这个其实是写在最后的，之所以放在这里，是因为它很重要！
如果你有一定的MD语法基础，可以直接点击跳转
Markdown 相关软件推荐
Markdown 语法
- 提示1： 本教程推荐使用 Obsidian 打开阅读
- 提示2： 下文提到的所有标识符都是 英文状态 的 ！
1. 标题&目录
1.1 标题
- Markdown标题共有 六级，和 HTML 一样
区分 一级标题 → 六级标题
这是一段普通的文本
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
1.2 目录
目录的 格式：
- 在文档的顶部 输入
[toc] ，会根据 标题 自动生成目录 ( Table of Content )
不是所有 MD编辑器 都支持目录生成
- Obsidian 就不支持，不过 OB 是自带大纲的，就是目录的效果
输入下方内容会生成一个目录：
[toc]
2. 斜体&粗体
2.1 斜体
斜体 的格式：
* + 文本内容 + *_ + 文本内容 + _ ( 下划线 )
说明：
这是一段普通文本
*这里是一段斜体文本*
_这也是一段斜体文本_
示范
这是一段普通文本
这里是一段斜体文本
这也是一段斜体文本
2.2 粗体
粗体 的格式：
** + 文本内容 + **__ + 文本内容 + __ (这里是两个 _ )
说明：
这是一段普通文本
**这里是一段加粗文本**
__这也是一段加粗文本__
示范
这是一段普通文本
这里是一段加粗文本
这也是一段加粗文本
2.3 粗斜体 (斜粗体)
粗斜体 的格式：
*** + 文本内容 + ***___ + 文本内容 + ___ （ 这里是3个 _ )**_ + 文本内容 + _**__* + 文本内容 + *__*__ + 文本内容 + __*_** + 文本内容 + **_
说明：
这是一段普通文本
***粗斜体文本1***
___粗斜体文本2___
**_粗斜体文本3_**
__*粗斜体文本4*__
*__粗斜体文本5__*
_**粗斜体文本6**_
示范
这是一段普通文本
粗斜体文本1
粗斜体文本2
粗斜体文本3
粗斜体文本4
粗斜体文本5
粗斜体文本6
2.4 斜体包含粗体
斜体中包含粗体 的格式：
* + 斜体文本 + ** + 粗体文本 + ** + 斜体文本 + *_ + 斜体文本 + __ + 粗体文本 + __ + 斜体文本 + _ （ 这里是两个 _ )* + 斜体文本 + __ + 粗体文本 + __ + 斜体文本 + *_ + 斜体文本 + ** + 粗体文本 + ** + 斜体文本 + _
说明：
- 斜体 中包含 粗体，其实就是嵌套的关系，外层 是 斜体，内层 是 粗体
- 外层是斜体，标识符是单个；内层是粗体，标识符是两个
- 因为 粗体 是被包裹在 斜体 中的，所以显示效果为 斜粗体
这是一段普通文本
*这里是一段斜体中**包含粗体**的文字*
_这也是一段斜体中**包含粗体**的文字_
*这又是一段斜体中__包含粗体__的文字*
_这还是一段斜体中**包含粗体**的文字_
示范
这是一段普通文本
这里是一段斜体中包含粗体的文字
这也是一段斜体中包含粗体的文字
这又是一段斜体中包含粗体的文字
这还是一段斜体中包含粗体的文字
2.5 粗体包含斜体
粗体中包含斜体 的格式：
** + 粗体文本 + * + 斜体文本 + * + 粗体文本 + **__ + 粗体文本 + _ + 斜体文本 + _ + 粗体文本 + __ （ 这里是两个 _ )** + 粗体文本 + _ + 斜体文本 + _ + 粗体文本 + **__ + 粗体文本 + * + 斜体文本 + * + 粗体文本 + __
说明：
- 粗体 中包含 斜体，也就是嵌套的关系，外层 是 粗体，内层 是 斜体
- 外层是粗体，标识符是两个；内层是斜体，标识符是单个
- 因为 斜体 是被包裹在 粗体 中的，所以显示效果为 粗斜体
这是一段普通文本
**这里是一段粗体中*包含斜体*的文字**
__这也是一段粗体中_包含斜体_的文字__
**这又是一段粗体中_包含斜体_的文字**
__这还是一段粗体中*包含斜体*的文字__
示范
这是一段普通文本
这里是一段粗体中_包含斜体_的文字
这也是一段粗体中_包含斜体_的文字
这又是一段粗体中_包含斜体_的文字
这还是一段粗体中_包含斜体_的文字
3. 线
3.1 水平分割线
下面是一条水平分割线：
---
***
示范
3.2 文本删除线
删除线 的格式：
~~ + 文本内容 +~~ 首尾各加两个 ~ 波浪号
~~这是一段加了删除线的文本~~
示范
这是一段加了删除线的文本
3.3 文本下划线
<u>这是一段加了下划线的文本</u>
示范
这是一段加了下划线的文本
4. 列表&引用
4.1 有序列表
有序列表 的格式：
说明：
- 输入文本内容后，敲击 Enter 自动补全格式，并进入 下个 有序列表
- 若需要在同个列表内，增加 换行显示 的内容 (但不进入下个列表)
敲击 Shift + Enter ，即可另起一行输入文本 - 在有序列表的中间，插入一个新的列表，后面列表的 数字序号 会自动 递进 一层
- 即便在源代码模式中修改了数字序号，渲染界面依然是 依照顺序 显示的
1. 这是第一个有序列表 <!-- (Enter) -->
2. 这是第二个有序列表 <!-- (Enter) -->
3. 这是第三个有序列表
1. 这是第一个有序列表 <!-- (Shift + Enter) -->
这是同个列表下，另起一行的文本内容 <!-- (Enter) -->
2. 这是第二个有序列表 <!-- (Shift + Enter) -->
这是同个列表下，另起一行的文本内容
示范
- 这是第一个有序列表
- 这是第二个有序列表
- 这是第三个有序列表
- 这是第一个有序列表
这是同个列表下，另起一行的文本内容 - 这是第二个有序列表
这是同个列表下，另起一行的文本内容
补充
- 由于有序列表存在强制排序性，它的数字序号必然是逐一递进的
若你希望内容前的数字，不依照递进顺序排序，或者以 整百，整十数 排序 可以配合无序列表，在无序列表中输入：
数字 + . + 内容
#注意 点号 与 内容 之间，没有空格 (其实有空格也行，就是会感觉有点奇怪)
- 10.这是无序列表下，整十数排列的内容
- 20.这是无序列表下，整十数排列的内容
- 30.这是无序列表下，整十数排列的内容
- 100.这是无序列表下，整百数排列的内容
- 200.这是无序列表下，整百数排列的内容
- 300.这是无序列表下，整百数排列的内容
效果：
- 10.这是无序列表下，整十数排列的内容
- 20.这是无序列表下，整十数排列的内容
- 30.这是无序列表下，整十数排列的内容
- 100.这是无序列表下，整百数排列的内容
- 200.这是无序列表下，整百数排列的内容
- 300.这是无序列表下，整百数排列的内容
4.2 无序列表
- 无序列表 的格式：
- - + 空格 + 文本内容
说明：
- 输入文本内容后，敲击 Enter 自动补全格式，并进入 下个 无序列表
- 若需要在同个列表内，增加换行显示的内容 (但不进入下个列表)
敲击 Shift + Enter ，即可另起一行输入文本
- 这是第1个无序列表 <!-- (Enter) -->
- 这是第2个无序列表 <!-- (Enter) -->
- 这是第3个无序列表
- 这是第一个无序列表 <!-- (Shift + Enter) -->
这是同个列表下，另起一行的文本内容
- 这是第二个无序列表 <!-- (Shift + Enter) -->
这是同个列表下，另起一行的文本内容
示范
- 这是第1个无序列表
- 这是第2个无序列表
- 这是第3个无序列表
- 这是第一个无序列表
这是同个列表下，另起一行的文本内容 - 这是第二个无序列表
这是同个列表下，另起一行的文本内容
列表可在OB中，设置快捷键，在 批量处理与取消上 会更方便
4.3 引用
引用 的格式：
- > +
空格 + 文本内容 （空格可加可不加，我推荐是加上)
说明：
- 同个引用段落内的换行直接敲击 Enter 即可
- 若需添加 第二个独立引用段落 ，连续敲击 两下 Enter 即可
> 这是第一段引用文本的第1行 <!-- (Enter) -->
> 这是第一段引用文本的第2行 <!-- (Enter) -->
<!-- (Enter) -->
> 这是第二段引用文本的第1行 <!-- (Enter) -->
> 这是第二段引用文本内第2行
注： 后面的 > 敲回车会自动补上
示范
这是第一段引用文本的第1行
这是第一段引用文本的第2行
这是第二段引用文本的第1行
这是第二段引用文本的第2行
4.4 缩进&退格
在列表和引用的书写过程中，我们需要利用 ==缩进== 与 ==退格== ，让文章肌理分明，更具层级
缩进：
- Tab
- Ctrl + [ (左中括号)
退格：
- Shift + Tab
- Ctrl + ] （右中括号）
4.4.1 有序列表的缩&退
1. 第一级有序列表1 <!-- (Enter) -->
1. 第二级有序列表1 <!-- 写文本之前，先( Tab 或 Ctrl + ] ) ；写完文本后，再(Enter) -->
2. 第二级有序列表2 <!-- (Enter) -->
2. 第一级有序列表2 <!-- 写文本前，先 ( Shift + Tab 或 Ctrl + [ ) -->
补充说明：
- 有序列表的数字序号，即便你在源代码模式里 强行改掉 数字，它仍然会 依照顺序 显示
示范
第一级有序列表1
- 第二级有序列表1
- 第二级有序列表2
- 第一级有序列表2
4.4.2 无序列表的缩&退
- 第一级无序列表1 <!-- (Enter) -->
- 第二级无序列表1 <!-- 写文本前，先( Tab 或 Ctrl + ] ) ；写完后，再(Enter) -->
- 第二级无序列表2 <!-- (Enter) -->
- 第一级无序列表2 <!-- 写文本前，先 ( Shift + Tab 或 Ctrl + [ ) -->
示范
4.4.3 引用的缩&退
引用的 缩进 和列表 不同
- 如果要退回上一级，敲2下回车键即可
源码
> 这是第一级引用
> > 这是第二级引用 <!-- 这里手动加一个 > ，打完后，敲 2 下回车键 -->
>
> 这里又是第一级引用了
示范
这是第一级引用
这是第二级引用
这里又是第一级引用了
4.4.4 有序&无序&引用 连续套娃
1. 第一级 有序列表1 <!-- (Shift + Enter) -->
- 第二级 无序列表1 <!-- (Shift + Enter) -->
>第三级 引用1 <!-- (Enter) -->
- 第四级 无序列表2 <!-- (Shift + Enter) -->
1. 第五级 有序列表2 <!-- (Enter) -->
- 第四级 无序列表3 <!-- 写文本前，先( Shift + Tab 或 Ctrl + [ ) ；写完后再 (Enter) -->
>第三级 引用2 <!-- 写文本前，先( Shift + Tab 或 Ctrl + [ ) ；写完后再 (Enter × 2) -->
- 第二级 无序列表4 <!-- 写文本前，先( Shift + Tab 或 Ctrl + [ ) -->
2. 第一级 有序列表3 <!-- 写文本前，先( Shift + Tab 或 Ctrl + [ ) -->
示范
第一级 有序列表1
第二级 无序列表1
第三级 引用1
第四级 无序列表2
- 第五级 有序列表2
- 第四级 无序列表3
第三级 引用2
- 第二级 无序列表4
- 第一级 有序列表3
4.4.5 Obsidian 的一些缩退问题
- - 这是第一段就被缩进的列表
- 这是第二段被再次缩进的列表 <!-- 这里需按两次 Ctrl + ] ,Tab键是无效的 -->
- 这是第三段列表 <!-- Ctrl + [ -->
这是第一段就被缩进的列表
- 这是第二段被再次缩进的列表
5. 网页链接与图像
5.1 网页链接
网页链接的 格式：
- [ + 显示文本内容 + ] + ( + 链接地址 + 空格 + " + 提示信息文本 + " + )
说明：
[显示文本内容](链接地址 "提示信息文本")
[百度一下，你就知道](http://www.baidu.com "按住Ctrl点击跳转百度")
示范：
百度一下，你就知道
5.1.1链接的加粗
格式有两种：
把一对 ** 加在 ==显示文本内容==的首尾
把一对 ** 加在 链接格式==整体== 的首尾
5.2 图像
图像格式：
- 图像格式，就是在网页链接前面加个 ! (英文格式的)，
! 代表 可见 - 图片的提示信息，和网页链接一样，写在
" " 内 [ ] 方括号里的文字信息在 Markdown 没啥实质的作用，只是方便在源代码模式下，知道这个图片是什么，在渲染界面是不会显示的。有点类似于HTML img标签 里的 alt属性。
示范
6. 表格
Markdown的表格，比HTML简单很多
- | 是构成表格的主要 框架
- - 区分 表头 和 表格主体
- : 控制 表格内 文本内容 的 对齐方式
- Typora编辑器中 输入
Ctrl + T 即可快速插入表格，自由定义样式
|这里是表头1|这里是表头2|这里是表头3|
|:-|:-:|-:| <!--区分表头和表格主体，:代表文本对齐方式，分别是左对齐，居中对齐，右对齐-->
|单元格数据1|单元格数据2|单元格数据3|
|单元格数据4|单元格数据5|单元格数据6|
示范
| 这里是表头1 | 这里是表头2 | 这里是表头3 |
|---|
| 单元格数据1 | 单元格数据2 | 单元格数据3 |
| 单元格数据4 | 单元格数据5 | 单元格数据6 |
6.1 表格中文本内容的换行
- Mardown中表格，它的宽高是由 单元格数据内的文本内容 撑开 的
- 当我们输入一段很长很长的文本，它所在的单元格会变得过宽
如下图所示：
| 表头1 | 表头2 |
|---|
| 这是一段很长很长很长很长很长很长很长很长很长很长很长很长很长很长的文本 | 普通文本 |
- 若想对一段长文本进行换行，可以在 中间 插入一个
<br> （ 换行标签 )
| 表头1 | 表头2 |
|:-:|:-:|
|这是第一行文本<br>这是另起一行的文本|普通文本|
示范
| 表头1 | 表头2 |
|---|
这是第一行文本
这是另起一行的文本 | 普通文本 |
7. 代码域
7.1 行内代码
行内代码 的格式：
补充：
- 行内代码不一定非得写代码，也可以作为
着重标记，突出显示内容 - 行内代码中，源代码界面和渲染界面是完全一致的，标识符会失效
- 所谓行内代码： 只要你的屏幕足够宽，它就不会换行
`这是一段行内代码`
`<table border="1" cellspacing="0" width="500" height="500">`
`print("Hello, World!")`
`这是一行突出显示的文本内容`
示范
<table border="1" cellspacing="0" width="500" height="500">
print("Hello, World!")
这是一行突出显示的文本内容
7.2 代码块
代码块 的格式：
- 在首行和末行各加 三个 ` 反引号
在首行和末行各加 三个 ~ 波浪号
补充：
- 在代码块也不一定要写代码，可以写一段突出的文本内容，语言类型可以填写 txt 或者 干脆不写
- 代码块中，源代码界面和渲染界面是完全一致的，标识符会失效
- 在 Typora编辑器 ，用键盘按键脱离代码块区域，需输入： Ctrl + Enter
```语言种类
代码内容
代码内容
代码内容
```
下面是HTML代码块
```html
<table border="1">
<tr>
<td>row 1, cell 1</td>
<td>row 1, cell 2</td>
</tr>
<tr>
<td>row 2, cell 1</td>
<td>row 2, cell 2</td>
</tr>
</table>
```
下面是CSS代码块
```css
.box {
width: 600px;
height: 400px;
margin: 100px auto;
background-image: linear-gradient(black 33.3%,red 33.3%, red 66.6%, yellow 66.6%, yellow);
}
```
下面是JavaScript代码块
```js
// 定义一个30个整数的数组，按顺序分别赋予从2开始的偶数；然后按顺序每五个数求出一个平均值，放在另一个数组中并输出。试编程
let arr = [2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42, 44, 46, 48, 50, 52, 54, 56, 58, 60]
let newarr = [];
for (let i = 0, count = 0, sum = 0, len = arr.length; i < len; i++) {
sum += arr.shift();
count++;
if (count % 5 === 0) {
newarr.push(sum / 5);
sum = 0;
}
}
console.log(newarr);
let arr = [2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42, 44, 46, 48, 50, 52, 54, 56, 58, 60]
let newarr = [];
for (let i = 0, len = arr.length; i < len / 5; i++) {
let subarr = arr.splice(0, 5)
for (let j = 0, sum = 0; j < subarr.length; j++) {
sum += subarr[j];
}
newarr.push(sum / 5);
}
console.log(newarr);
```
下面是Python代码块
```python
#!/usr/bin/python
# -*- coding: UTF-8 -*-
i = 2
while(i < 100):
j = 2
while(j <= (i/j)):
if not(i%j): break
j = j + 1
if (j > i/j) : print i, " 是素数"
i = i + 1
print "Good bye!"
```
下面是一块突出显示的文本
```txt
这是一段
突出显示的
文本内容
```
示范
<table border="1">
<tr>
<td>row 1, cell 1</td>
<td>row 1, cell 2</td>
</tr>
<tr>
<td>row 2, cell 1</td>
<td>row 2, cell 2</td>
</tr>
</table>
.box {
width: 600px;
height: 400px;
margin: 100px auto;
background-image: linear-gradient(black 33.3%, red 33.3%, red 66.6%, yellow 66.6%, yellow);
}
// 定义一个30个整数的数组，按顺序分别赋予从2开始的偶数；然后按顺序每五个数求出一个平均值，放在另一个数组中并输出。试编程
let arr = [2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42, 44, 46, 48, 50, 52, 54, 56, 58, 60]
let newarr = [];
for (let i = 0, count = 0, sum = 0, len = arr.length; i < len; i++) {
sum += arr.shift();
count++;
if (count % 5 === 0) {
newarr.push(sum / 5);
sum = 0;
}
}
console.log(newarr);
let arr = [2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42, 44, 46, 48, 50, 52, 54, 56, 58, 60]
let newarr = [];
for (let i = 0, len = arr.length; i < len / 5; i++) {
let subarr = arr.splice(0, 5)
for (let j = 0, sum = 0; j < subarr.length; j++) {
sum += subarr[j];
}
newarr.push(sum / 5);
}
console.log(newarr);
#!/usr/bin/python
# -*- coding: UTF-8 -*-
i = 2
while(i < 100):
j = 2
while(j <= (i/j)):
if not(i%j): break
j = j + 1
if (j > i/j) : print i, " 是素数"
i = i + 1
print "Good bye!"
这是一段
突出显示的
文本内容
7.2.1 代码块的嵌套
格式：
示范
````txt
```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); // 打印总和
```
````
如果要再套一层，就在最外层 加 5个 ` ，以此类推……
7.3 如何在行内代码里显示反引号
首尾各用 两个反引号 ` + 空格 包裹
格式：
``+空格+带`的内容+空格+`` <!-- 不要忘记前后的两个空格 -->
`` 这是一段能显示`反引号`的行内代码 ``
效果：
这是一段能显示`反引号`的行内代码
8. 任务列表（待办）
任务列表 的格式：
- - + 空格 +
[ ] +空格 + 任务列表内容 ( 中括号[ ] 里面必须有个空格) 给待办任务列表打 √ ，变成 已办
- 在渲染界面，直接鼠标左键点击框框
在源代码界面，在中括号内输入 英文字母x
- 部分编辑器，在 中括号内 输入任意字符都可以打
√ ( 例如 Obsidian )
补充：
- 格式：
- [ ] 待办任务列表1
- [ ] 待办任务列表2
- [x] 已办任务列表1 <!-- 英文字母X -->
- [x] 已办任务列表2
示范
- [ ] 待办任务列表1
- [ ] 待办任务列表2
- [x] 已办任务列表1
- [x] 已办任务列表2
- 任务列表也是可以缩进+退格的，操作跟 无序、有序列表一样
示范
9. 注释
Markdown 的 注释 和 HMTL 一样，注释的内容在 渲染界面 不可见 （部分编辑器可见)
<!-- 这里是一行注释 -->
<!--
这里是
一段
假装有
很多行的
注释
-->
%%这是一行Obsidian里的注释%%
%%
这里是
一段
假装有
很多行的
Obsidian里的
注释
%%
示范 (只有切换至 编辑模式 才能看到喔)
10. 变量
10.1 网页链接变量
网页链接变量 的格式：
首先输入
在文档任意一个区域，输入：
[变量名] + : + 空格 + 链接地址 （这个空格 不打也没事)
[百度一下，你就知道][度娘]
[知乎-有问题，就会有答案][知乎]
<!-- 这里是变量区域 -->
[度娘]: http://www.baidu.com
[知乎]: https://www.zhihu.com
示范
百度一下，你就知道
知乎-有问题，就会有答案
10.2 脚注
脚注 的格式：
在需要脚注的地方，输入：
在其他区域，输入：
[^脚注代号] + : + 空格 + 脚注内容 （这个 空格 不打也没事)
鲁迅原名是什么[^1] ，浙江哪里人[^2]
<!-- 这里是变量区域 -->
[^1]: 周树人
[^2]: 绍兴人
示范
鲁迅原名是什么[[1]](https://publish.obsidian.md/#fn-1-a142f421385130e7)，浙江哪里人[[2]](https://publish.obsidian.md/#fn-2-a142f421385130e7)
11. 拓展文本格式标记
- Markdown 想实现更多的文本显示效果，只能依赖HTML标记实现
- 个人不是很推荐在 MD 中使用 HTML，不过一些简单的标记还是可以 轻度使用 的
11.1 键盘文本
键盘文本的 格式：
<kbd>键盘文本</kbd><kbd>Ctrl</kbd> + <kbd>X</kbd>
效果：
说明：
11.1.1 加粗键盘文本
加粗键盘文本的格式有两种：
<kbd>**键盘文本**</kbd>**<kbd>ctrl + x</kbd>**
效果：
- 键盘文本
- ctrl + x
11.2 放大文本
放大文本 的格式：
这是一段普通文本
<big>这是一段放大文本</big>
效果：
11.2.1 放大粗体文本
放大加粗文本的格式有两种：
**<big>这是一段放大粗体文本</big>**<big>**这是一段放大粗体文本**</big>
效果：
- 这是一段放大粗体文本
- 这是一段放大粗体文本
11.3 缩小文本
缩小文本 的格式：
这是一段普通文本
<small>这是一段缩小文本</small>
效果：
11.3.1 缩小斜体文本
斜体缩小文本 的格式有两种：
<small>*这是一段缩小斜体文本*</small>*<small>这是一段缩小斜体文本</small>*
效果：
- 这是一段缩小斜体文本
- 这是一段缩小斜体文本
11.4 多彩文本
多彩文本 的格式：
<font color=orange>这是一段橘色文本</font>
效果：
11.4.1 多彩粗体文本
11.4.2 多彩斜体文本
- 跟多彩加粗文本完全一样，只需把首尾的
** 换成 * 即可
格式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_
11.4.2 多彩粗斜体文本
格式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 的核心就是 简洁精炼，注重 实质内容，而非花哨的 颜色样式
12. 拓展文本显示效果
- 拓展显示效果既不是原生 Markdown语法 支持的，也非 HTML标记，而是部分编辑器 提供的 额外标识符，属于拓展语法，旨在为 Markdown使用者 提供更多样式选择
- 不同编辑器，支持不一样，这里以 Typora编辑器 为例
12.1 文本高亮
12.2 上标
用一对 ^ 包裹 (Shift+ 6)
- Obsidian 没效果的，可以用后面会讲的 Latex
或者，也可以使用 HTML标记
<sup>这里是上标内容</sup>X<sup>2</sup>
效果：
12.3 下标
用一对 ~ 包裹 (Shift + `)
- Obsidian 没效果的，可以用后面会讲的 Latex
或者，也可以使用 HTML标记
<sub>这里是下标内容</sub>H<sub>2</sub>O
效果：
12.4 Emoji 符号
用一对 : 包裹，里面是 Emoji 符号的 语义化文本 ( Typora编辑器 中，输入 : 就会带提示器 )
示例：
:smile:
:sweat:
:cat:
:woman_cartwheeling:
效果：
- :smile:
:sweat:
:cat:
:woman_cartwheeling:
13. 转义字符
例1 以普通字符显示星号
例2 表格内 单元格中的竖杠
- 在表格中，使用 | 作为单元格的内容，但不会被识别为表格的结构，不会增加额外的单元格
|表头1|表头2|
|-|-|
|这里的文本被\|分隔|这里的文本也被\|分隔|
| 表头1 | 表头2 |
|---|
| 这里的文本被\ | 分隔 | 这里的文本也被\ | 分隔 |
#补充 该技巧可用于 Obsidian 表格内 双链的文本修饰
文本修饰：
在 双链[[ ]]内 以 | 引导的内容
- 格式：
[[链接的内容|文本修饰]] - 说明： 文本修饰是渲染界面实际显示的文本，便于更好地融入语境
表格内的格式：
在 | 前面加上 \
示例：
| 表头1 | 表头2 |
|:---------------------------------------:|:---------------------------------------------------:|
| [[#例2 表格内 单元格中的竖杠\|单元格中的竖杠]] | [[#例3 不会变成代码的反引号\|不会变成代码的反引号]] |
效果：
例3 不会变成代码的反引号
使用 转义符号\ 让 反引号 ` 变成普通字符，不再具有行内代码的标识符功能
格式：
\`这段被反引号包裹的内容不会变成行内代码\`
效果：
这段被反引号包裹的内容不会变成行内代码
例4 链接中的中括号
在 网页链接 的 显示文本内容 中，使用 中括号 [ ]
例5 不是列表的连接符(横杠)
- 引用一段话，一般会在换行之后，加上
- 出处 - 因为 - 是标识符，会变成一个无序列表
如下所示：
The Web, the Tree, and the String.
写作之难，在于把网状的思考，用树状结构，体现在线性展开的语句里。
解决方法：
>The Web, the Tree, and the String.
>写作之难，在于把网状的思考，用树状结构，体现在线性展开的语句里。
>\- 史蒂芬·平克 <!-- 加上转义符号 \ , 不会变成无序列表 -->
- 效果：
The Web, the Tree, and the String.
写作之难，在于把网状的思考，用树状结构，体现在线性展开的语句里。
例6 不是标题的
让 # 不被识别为标题标识符
格式：
\# 这里的内容不会被识别为标题
效果：
这里的内容不会被识别为标题
例7 不会注释的 %
在 Obsidian 中 注释是前后各两个 % 号
使用 转义符号\，让 %% 作为普通字符显示出来，不具备注释的功能
- 格式：
\%\%这里的内容可以被显示喔\%\% - 效果： %%这里的内容可以被显示喔%%
例8 木有链接的双链
Obsidian 的双向链格式是2个方括号 [[ ]] (双方)，使用 转义符号\，让 [ ] 不再具有 双链功能
格式：
\[\[这段文本被双方包裹，但不是一个双向链\]\]
效果：
[[这段文本被双方包裹，但不是一个双向链]]
例9 页链接里 显示文本内的 中括号
使用转义符号\，让中括号可以作为显示文本 在网页链接中显示出来
格式：
[\[这是一个带中括号的网页链接显示文本，点击会跳转至百度\]](https://www.baidu.com/)
效果：
[[这是一个带中括号的网页链接显示文本，点击会跳转至百度]](https://www.baidu.com/)
特殊情况 文本修饰的中括号
文本修饰的 中括号[ ] 不需要使用 转义符号\
示范：
[[#例8 木有链接的双链|[这是一个带中括号的文本修饰]]]
效果：
[这是一个带中括号的文本修饰]
14. 空格&换行&强制删除
14.1 空格
14.2 换行
场景1：
格式：
这里是第一段文本
<br><br><br><br><br> <!-- 这里插入了5个空行间距 -->
这里是第二段文本
效果：
这里是第一段文本
这里是第二段文本
场景2：
- 这是一段无序列表
<br> <!-- 插入一个空行间距，需单独一行，上下不用预留空格 -->
这是同一段无序列表中，空一行距离显示的内容
- 这是第二段无序列表
效果：
这里是同一段无序列表中，空一行距离显示的内容
14.3 强制删除
15. 嵌入
15.1 嵌入音频
格式：
<audio controls="controls" preload="none" src="音频链接地址"></audio>
- 示例：
<audio controls="controls" preload="none" src="https://www.ldoceonline.com/media/english/exaProns/p008-001803372.mp3?version=1.2.37"></audio>
15.2 嵌入视频
<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
15.3 嵌入页面
- 格式：
<iframe width=600 height=400 src="页面链接地址" scrolling="auto" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>
<iframe width=600 height=400 src="https://www.runoob.com/html/html-tutorial.html" scrolling="auto" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>
<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>
16. Latex 数学公式
16.1 行内公式
示例：
$x^2 + 2x + 5 + \sqrt x = 0$$\ce{CO2 + C -> 2 CO}$$\ce{CO2 + C -> 2 CO}$$\ce{2Mg + O2 ->[燃烧] 2 MgO}$
16.2 公式块
% 化学公式
$$
\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
$$
17. Mermaid
- 一些 MD编辑器 和 笔记软件 支持通过 Mermaid 及其所提供的 编译器 来为用户提供图表的绘制功能
这里只提供一些演示的图表，具体教程可戳下方
17.1 流程图
源码1：
```mermaid
graph TB
%% s=start e=end f=fork n=normal
s([开始])-->f1{{if条件}};
%% 分支点2
f1--true-->n1[if语句块]-->e([结束]);
f1--false-->f2{{else if条件}};
%% 分支点1
f2--true-->n2[else if语句块]-->e;
f2--false-->n3[else语句块]-->e;
```
渲染1：
源码2：
```mermaid
graph LR
%% s=start e=end f= fork n=normal
%% 虚线
s[朱百六]-.->|子|n1[朱四九]-.->|子|n2[朱五四]-.->|子|f1_帝((朱八八))
%% 分支点 朱八八
f1_帝-->|长子|f2[朱标]
f1_帝-->|次子|n3[朱樉]
f1_帝-->|三子|n4[朱棢]
f1_帝-->|四子|n5_帝((朱棣))
%% 分支点 朱标
f2-->|长子|e1[朱雄英]
f2-->|次子|e2_帝((朱允炆))
n5_帝-->|长子|e3[朱高炽]
```
渲染2：
17.2 饼图
源码：
```mermaid
pie
title 为什么总是宅在家里？
"喜欢宅" : 45
"天气太热" : 70
"穷" : 500
"关你屁事" : 95
```
渲染：
6%10%70%13%为什么总是宅在家里？喜欢宅天气太热穷关你屁事
17.3 序列图 (时序图)
源码：
```mermaid
sequenceDiagram
%% 自动编号
autonumber
%% 定义参与者并取别名，aliases：别名
participant A as Aly
participant B as Bob
participant C as CofCai
%% 便签说明
Note left of A: 只复习了一部分
Note right of B: 没复习
Note over A,B: are contacting
A->>B: 明天是要考试吗？
B-->>A: 好像是的！
%% 显示并行发生的动作，parallel：平行
%% par [action1]
rect rgb(0, 25, 155)
par askA
C -->> A:你复习好了吗？
and askB
C -->> B:你复习好了吗？
and self
C ->>C:我还没准备复习......
end
end
%% 背景高亮，提供一个有颜色的背景矩形
rect rgb(25, 55, 0)
loop 自问/Every min
%% <br/>可以换行
C ->> C:我什么时候<br/>开始复习呢？
end
end
%% 可选择路径
rect rgb(153, 83, 60)
alt is good
A ->> C:复习了一点
else is common
B ->> C:我也是
end
%% 没有else时可以提供默认的opt
opt Extra response
C ->> C:你们怎么不回答我
end
endsequenceDiagram
%% 自动编号
autonumber
%% 定义参与者并取别名，aliases：别名
participant A as Aly
participant B as Bob
participant C as CofCai
%% 便签说明
Note left of A: 只复习了一部分
Note right of B: 没复习
Note over A,B: are contacting
A->>B: 明天是要考试吗？
B-->>A: 好像是的！
%% 显示并行发生的动作，parallel：平行
%% par [action1]
rect rgb(0, 25, 155)
par askA
C -->> A:你复习好了吗？
and askB
C -->> B:你复习好了吗？
and self
C ->>C:我还没准备复习......
end
end
%% 背景高亮，提供一个有颜色的背景矩形
rect rgb(25, 55, 0)
loop 自问/Every min
%% <br/>可以换行
C ->> C:我什么时候<br/>开始复习呢？
end
end
%% 可选择路径
rect rgb(153, 83, 60)
alt is good
A ->> C:复习了一点
else is common
B ->> C:我也是
end
%% 没有else时可以提供默认的opt
opt Extra response
C ->> C:你们怎么不回答我
end
end
```
渲染：
AlyBobCofCai只复习了一部分没复习are contactingparaskA[self]loop[自问/Everymin]altis goodopt[Extraresponse]明天是要考试吗？1好像是的！2你复习好了吗？3你复习好了吗？4我还没准备复习......5我什么时候开始复习呢？6复习了一点7我也是8你们怎么不回答我9AlyBobCofCai
17.4 甘特图
源码：
```mermaid
gantt
title A Gantt Diagram
dateFormat YYYY-MM-DD
section Section
A task :a1, 2014-01-01, 30d
Another task :after a1 , 20d
section Another
Task in sec :2014-01-12 , 12d
another task : 24d
```
渲染：
2014-01-052014-01-122014-01-192014-01-262014-02-022014-02-092014-02-16A taskTask in secanother taskAnother taskSectionAnotherA Gantt Diagram
17.5 类图
源码：
```mermaid
classDiagram
Animal <|-- Duck
Animal <|-- Fish
Animal <|-- Zebra
Animal : +int age
Animal : +String gender
Animal: +isMammal()
Animal: +mate()
class Duck{
+String beakColor
+swim()
+quack()
}
class Fish{
-int sizeInFeet
-canEat()
}
class Zebra{
+bool is_wild
+run()
}
```
渲染：
18. 标签 (Tag)
- 标签是 Obsidian 特有的一个功能，标签可以通过点击唤起快速搜索 (搜索包含该标签的所有笔记)
格式：
关于空格
与 标签名 之间，不能有空格，否则就变成 一级标题 了
关于数字
标签内允许使用数字，但不能完全由数字组成
#1984 ❌#1984Date ⭕#da_1984_te ⭕#date-1984 ⭕
标签的嵌套
在标签名内，使用 / 斜杠 可以实现标签的嵌套
格式：
#主标签/子标签1#主标签/子标签2#主标签/子标签3
嵌套标签可以像普通标签一样通过点击来唤起搜索，嵌套标签允许你选择搜索的层次。例如：
能被使用的符号
综上所述，标签内能被使用的符号共有三种
_ 下划线- 连字符/ 斜杠
如何让 # 不被识别
可以使用前面提到的转义符号 \ 反斜杠，与上述的 转义标题 类似
格式：
\#这里的内容不会被识别为标签
效果：
这里的内容不会被识别为标签
19. 避免标识符的滥用
即使在 Markdown 中，也要尽量避免标识符的滥用
比如我的这篇教程，就存在一定程度的滥用
标识符的本质是突出显示，代表重点
- 一篇笔记里的某段文本，使用各式各样的的标识符，会造成重点不清晰
有三种标识，慎用！
词中对单个汉字的标识
- 卧==虎==藏==龙==
短语中对单个英语单词的标识
- get a ==bang== out of
标识符的多层嵌套
- 我感觉快要==原地
起飞==了
原因：
20. Callouts
20.1 Callouts 语法
Callouts 以前是第三方插件 Admonitions 的功能，现在被内置到OB自身，在 ==Publish== 中也可使用
也可 用 / 引导，输入 /callout 也可快速插入
格式
> [!类型] 标题
> 内容
注：
- 不要忘记
> ] 与 标题 间有空格
示范
这是一个callout标题
这里是callout里的内容
callout内部支持双链
源码
> [!note] 这是一个callout标题
> 这里是callout里的内容
> [[#20 Callout blocks|callout]]内部支持双链
> - 同样支持==MD语法==
20.2 折叠与展开
[!note] 默认是展开的，且不能折叠
如果想让 Callouts 有折叠的功能，可在 ] 后面加上 + 加号
示范
> [!note]+ 这是一个可折叠的标题
> 这里的内容可通过点击 **Callouts标题** 折叠起来
效果
这是一个可折叠的标题
这里的内容可通过点击 Callouts标题 折叠起来
在后面加上 - 减号，默认处于折叠状态 [!note]-
示范
> [!note]- 这是一个已被折叠的标题 （点击可展开）
> 里面的内容默认看不到
效果
这是一个已被折叠的标题（点击可展开）
20.3 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] 这是一个bug类别
> 这里是内容
这是一个bug类别
这里是内容
20.4 多层嵌套
Callouts 支持多层嵌套
示范
> [!failure] 这是第一层
> 这里是第一层的内容
>> [!bug]+ 这是嵌套的第二层
>> 这里是第二层的内容
>>> [!warning]- 这是嵌套的第三层，且默认为折叠状态
>>> 这里是第三层被折叠的内容
效果
这是第一层
这里是第一层的内容
这是嵌套的第二层
这里是第二层的内容
这是嵌套的第三层，且默认为折叠状态
支持用CSS来自定义类型和图标，不过我个人没怎么用
具体可戳 Use callouts - Obsidian Help
- 周树人↩︎
- 绍兴人↩︎
