MD (Markdown) 语法详细教程 obsidian 社区转载

WABC · 2024 年12 月 25 日 06:11

作者 yikelee 成雙醬

MD语法教程，适合新手入门，也适合老手瞅瞅
初稿写了一周左右，前前后后又修改了一个多月
应该是比较完善了

Mermaid ，iframe ， Latex 部分 在论坛里显示有问题
可以去 网页发布版 或 MD源文件 获得最佳阅读体验

本教程有发布publish上
Markdown 超级教程by成雙醬

需要原 MD文档 和 PDF 的，可以戳下面的网盘链接

百度网盘：
链接：https://pan.baidu.com/s/13ZoKSRZkqQc_JuxK3AGFmA
提取码：tqp8

阿里云盘：
链接：https://www.aliyundrive.com/s/eooT6xPzLhh

以下是教程内容

什么是 Markdown?

Markdown 是一款轻量级标记语言，不同于HTML (Hypertext Markup Language)，Markdown 的语法非常简单且容易上手
Markdown 以 纯文本格式 编写文档，依赖键盘而非鼠标，专注于写作本身，感受书写的魅力
Markdown 的通过添加一些简单的 标识符，让文本具有恰到好处的格式
Markdown 核心特征就是 删繁剪芜， **简扼 **+ 精炼
Markdown 是笔记与 网页文章 的最佳载体
Down 的核心：坐下来，就能把思维写下来

牛津高阶英汉双解词典第九版 中，关于 down 的释义：

Markdown 相关软件推荐

Markdown 书写软件 推荐：Typora 优秀的 MD网页文章书写软件
- 点击跳转下载地址
Markdown 笔记软件 推荐：Obsidian 银河系最强 MD+ 双向链 笔记软件
- 点击跳转下载地址

Markdown 语法

1. 标题&目录

1.1 标题

Markdown标题共有六级，和 HTML 一样
区分 一级标题 → 六级标题
- 标题的格式：
  - # × 标题级数 + 空格 + 文本内容

这是一段普通的文本

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

1.2 目录

目录的格式：
- 在文档的顶部输入 [toc] ，会根据标题自动生成目录 ( Table of Content )
不是所有 MD编辑器 都支持目录生成

输入下方内容会生成一个目录：

[toc]

2. 斜体&粗体

2.1 斜体

斜体的格式：
1. * + 文本内容 + *
2. _ + 文本内容 + _ ( 下划线 )
说明：
斜体文本，首尾只有单个标识符

这是一段普通文本

*这里一段斜体文本*
_这也是一段斜体文件_

2.2 粗体

粗体的格式：
1. ** + 文本内容 + **
2. __ + 文本内容 + __ (这里是两个 _ )
说明：
- 粗体文本，首尾各有两个标识符

这是一段普通文本

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

2.3 粗斜体 (斜粗体)

粗斜体的格式：
1. *** + 文本内容 + ***
2. ___ + 文本内容 + ___ （这里是3个 _ )
3. **_ + 文本内容 + _**
4. __* + 文本内容 + *__
5. *__ + 文本内容 + __*
6. _** + 文本内容 + **_
说明：
- 粗斜体文本，首尾各有三个标识符

这是一段普通文本

***粗斜体文本1***
___粗斜体文本2___
**_粗斜体文本3_**
*__粗斜体文本5__*
_**粗斜体文本6**_

2.4 斜体包含粗体

斜体中包含粗体的格式：
1. * + 斜体文本 + ** + 粗体文本 + ** + 斜体文本 + *
2. _ + 斜体文本 + __ + 粗体文本 + __ + 斜体文本 + _ （这里是两个 _ )
3. * + 斜体文本 + __ + 粗体文本 + __ + 斜体文本 + *
4. _ + 斜体文本 + ** + 粗体文本 + ** + 斜体文本 + _
说明：
- 斜体中包含粗体，其实就是嵌套的关系，外层是斜体，内层是粗体
- 外层是斜体，标识符是单个；内层是粗体，标识符是两个
- 因为粗体是被包裹在斜体中的，所以显示效果为 斜粗体

这是一段普通文本

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

2.5 粗体包含斜体

粗体中包含斜体的格式：
1. ** + 粗体文本 + * + 斜体文本 + * + 粗体文本 + **
2. __ + 粗体文本 + _ + 斜体文本 + _ + 粗体文本 + __ （这里是两个 _ )
3. ** + 粗体文本 + _ + 斜体文本 + _ + 粗体文本 + **
4. __ + 粗体文本 + * + 斜体文本 + * + 粗体文本 + __
说明：
- 粗体中包含斜体，也是嵌套的关系，外层是粗体，内层是斜体
- 外层是粗体，标识符是两个；内层是斜体，标识符是单个
- 因为斜体是被包裹在粗体中的，所以显示效果为 粗斜体

这是一段普通文本

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

3. 线

3.1 水平分割线

下面是一条水平分割线：
---
***

示范

3.2 文本删除线

删除线的格式：
- ~~ + 文本内容 +~~ 首尾各加两个 ~ 波浪号

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

3.3 文本下划线

下划线的格式，和 HTML 是一样的
-  + 文本内容 +

<u>这是一段加了下划线的文本</u>

示范

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

4. 列表&引用

4.1 有序列表

有序列表的格式：
- 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 ，即可另起一行输入文本
补充：
- 在Obsidian中，按下 Ctrl + Enter
- 即可快速生成一个无序列表

- 这是第1个无序列表 <!-- (Enter) -->
- 这是第2个无序列表 <!-- (Enter) -->
- 这是第3个无序列表

- 这是第一个无序列表 <!-- (Shift + Enter) -->
  这是同个列表下，另起一行的文本内容
- 这是第二个无序列表 <!-- (Shift + Enter) -->
  这是同个列表下，另起一行的文本内容

示范

这是第1个无序列表
这是第2个无序列表
这是第3个无序列表
这是第一个无序列表
这是同个列表下，另起一行的文本内容
这是第二个无序列表
这是同个列表下，另起一行的文本内容

4.3 引用

引用的格式：
- > + 文本内容（不需要空格)
说明：
- 同个引用段落内的换行直接敲击 Enter 即可
- 若需添加 第二个独立引用段落 ，连续敲击两下 Enter 即可

>这是第一段引用文本的第1行 <!-- (Enter) -->
>这是第一段引用文本的第2行 <!-- (Enter) -->
<!-- (Enter) -->
>这是第二段引用文本的第1行 <!-- (Enter) -->
>这是第二段引用文本内第2行

示范

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

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

4.4 缩进&退格

在列表和引用的书写过程中，我们需要利用 ==缩进== 与 ==退格== ，让文章肌理分明，更具层级

缩进：
1. Tab
2. Ctrl + [ (左中括号)
退格：
1. Shift + Tab
2. 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 + [ ) -->

示范

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

4.4.3 引用的缩&退

引用的缩进和列表不同
- 引用需另起一行，并额外多打一个 > 来完成缩进
引用的退格与列表相同
1. Shift + Tab
2. Ctrl + ] （右中括号）

>第一级引用1 <!-- (enter) -->
>>第二级引用1 <!-- 先打1个 > (这里的第一个 > 是会自动补充的，只需额外增补1个即可) ，再(enter) -->
>>第二级引用2 <!-- (enter) -->
>第一级引用2   <!-- 写文本前，先 ( Shift + Tab 或 Ctrl + [ ) -->

示范

第一级引用1

第二级引用1
第二级引用2

第一级引用2

补充：
在 Obsidian 中，引用的退格是不太一样的
Obsidian 中，如果想让已经缩进的引用 退回一层
- 得使用 Shift + Enter ，配合方向键，在多个 > 之间灵活断行
  并在下一行根据需要选择性补充 >
这个用文字比较难以描述，这里选择用2个带键位的 Gif图 来描述

Gif演示1：

引用退格1

Gif演示2：

引用退格2

4.4.4 有序&无序&引用连续套娃

有序列表、无序列表、引用三者之间，可以相互嵌套
核心键 ： Shift + Enter & Enter & Shift + Tab ( 或 Ctrl + [ )
- Shift + Enter 在切换格式的嵌套中，是自带一层缩进效果的

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
  1. 第五级 有序列表2
* 第四级 无序列表3

第三级引用2

第二级无序列表4

第一级有序列表3

4.4.5 Obsidian 的一些缩退问题

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

- - 这是第一段就被缩进的列表
	- 这是第二段被再次缩进的列表  <!-- 这里需按两次 Ctrl + ] ,Tab键是无效的 -->
  - 这是第三段列表  <!-- Ctrl + [ -->

- 这是第一段就被缩进的列表

这是第二段被再次缩进的列表
- 这是第三段列表

5. 网页链接与图像

5.1 网页链接

网页链接的格式：
- [ + 显示文本内容 + ] + ( + 链接地址 + 空格 + " + 提示信息文本 + " + )
说明：
- 显示文本内容，是在渲染界面实际可见的文本，用以说明链接
- 提示信息文本，需鼠标悬停于 显示文本内容 方可触发，用于增加额外提示信息
  - "提示信息文本" 是可选项，可填可不填
  - 一般来讲，需按住 Ctrl + 鼠标左键点击 才可跳转链接，不过也有 直接鼠标点击 就能跳转的

[显示文本内容](链接地址 "提示信息文本")

[百度一下，你就知道](http://www.baidu.com "按住Ctrl点击跳转百度")

示范：

百度一下，你就知道

5.2 图像

图像格式：
- 图像格式，就是在网页链接前面加个 ! (英文格式的)，! 代表可见
- 图片的提示信息，和网页链接一样，写在 " " 内
- [ ] 方括号里的文字信息在 Markdown 没啥实质的作用，只是方便在源代码模式下，知道这个图片是什么，在渲染界面是不会显示的。有点类似于HTML img标签 里的 alt属性。

![文字信息](图片链接 "提示文本信息")	

![湘湖1](upload://Ad5F9UZAOlZkz4iRuGeEuRugdZ.jpeg "湘湖一角")

补充：
- 图像链接可以是本地的，也可以是在线的
  - 本地图像直接 Ctrl + C 黏贴，Ctrl + V 复制就可以
  - 在线图像推荐使用图床
- 调整图像的大小需要使用 HTML 和 CSS，在 Typora编辑器 中右键可以直接缩放图片
  本质是转成了HTML的格式，最后会有一个 style="zoom: %;" ，这里数值可以自己修改
- 如果有使用 Obsidian 的朋友，在线图片链接是通用的，不过因为Obsidian 是双向链笔记它的本地图片的格式是：
  - ![[ 图片 ]]
    - 本质是为图片建了一个新的MD文件，用 ! 使它可见
    - Obsidian的图片设置大小是用 | 分隔后面跟宽度数值，单位是px。
      设置好宽度，高度会自动 等比例调整
      - ![[图片名|宽度数值]]

示范

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
这是一段很长很长很长很长很长很长很长很长很长很长很长很长很长很长的文本	普通文本

若想对一段长文本进行换行，可以在中间插入一个   （换行标签 )

| 表头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 代码块

代码块的格式：
1. 在首行和末行各加三个 ` 反撇号
- ** + 语言种类代码内容 **
1. 在首行和末行各加三个 ~ 波浪号
- ~~~ + 语言种类
  代码内容
  ~~~
补充：
- 在代码块也不一定要写代码，可以写一段突出的文本内容，语言类型可以填写 txt 或者 干脆不写
- 代码块中，源代码界面和渲染界面是完全一致的，标识符会失效
- 在 Typora编辑器 ，用键盘按键脱离代码块区域，需输入： Ctrl + Enter

```语言种类
代码内容
代码内容
代码内容

下面是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代码块

.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代码块

    // 定义一个30个整数的数组，按顺序分别赋予从2开始的偶数；然后按顺序每五个数求出一个平均值，放在另一个数组中并输出。试编程
    var 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]
    var newarr = [];
    for (var 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);

    var 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]
    var newarr = [];
    for (var i = 0, len = arr.length; i < len / 5; i++) {
        var subarr = arr.splice(0, 5)
        for (var j = 0, sum = 0; j < subarr.length; j++) {
            sum += subarr[j];
        }
        newarr.push(sum / 5);
    }
    console.log(newarr);

下面是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!"

下面是一块突出显示的文本

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


#### 示范

row 1, cell 1	row 1, cell 2
row 2, cell 1	row 2, cell 2

```

.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开始的偶数；然后按顺序每五个数求出一个平均值，放在另一个数组中并输出。试编程
    var 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]
    var newarr = [];
    for (var 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);

    var 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]
    var newarr = [];
    for (var i = 0, len = arr.length; i < len / 5; i++) {
        var subarr = arr.splice(0, 5)
        for (var 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!"

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

8. 任务列表（待办）

任务列表的格式：
- - + 空格 +[ ] +空格 + 任务列表内容 ( 中括号[ ] 里面必须有个空格)
- 给待办任务列表打 √ ，变成已办
  1. 在渲染界面，直接鼠标左键点击框框
  2. 在源代码界面，在中括号内输入 英文字母x
  - 部分编辑器，在中括号内输入任意字符都可以打 √ ( 例如 Obsidian )
补充：
- 大部分 MD编辑器支持输入第一个任务列表后，按下 Enter 进入下一行会 自动补全待办格式
- 在Obsidian中，连续输入两次 Ctrl + Enter ，即可生成一个待办列表
  - 再输入一次 Ctrl + Enter ，会在待办列表打 √
格式：

- [ ] 待办任务列表1
- [ ] 待办任务列表2
- [x] 已办任务列表1    <!-- 英文字母X -->
- [x] 已办任务列表2

示范

待办任务列表1
待办任务列表2
已办任务列表1
已办任务列表2
在 Obsidian 中，可以利用 Ctrl + Enter ，快速生成任务列表
1. - + 空格 + Ctrl + Enter +待办文本内容
2. 待办文本内容 + Ctrl + Enter ×2 ( 输入文本后，连续2次 Ctrl + enter )
任务列表也是可以缩进+退格的，操作跟无序、有序列表一样

示范

第一级待办列表1
- 第二级待办列表1
  另起一行的第二级待办列表1
  - 第三级已办列表1
  - 第三级已办列表2
- 第二级待办列表2
  另起一行的第二级待办列表2
第一级待办列表2

9. 注释

Markdown 的注释和 HMTL 一样，注释的内容在 渲染界面 不可见 （部分编辑器可见)

注释的格式：
- 
 - 注释可以是单行，也可以是多行
- 如果有在使用 Obsidian 的，它的注释格式是不一样的
 - %%这是Obsidian的注释内容%%

<!-- 这里是一行注释 -->

<!--
这里是
一段
假装有
很多行的
注释
-->

10. 变量

10.1 网页链接变量

网页链接变量的格式：
1. 首先输入
- [显示文本内容] + [变量名]
  - 变量名可以自己取，没啥限制，任意字符都可以
1. 在文档任意一个区域，输入：
- [变量名] + : + 空格 + 链接地址（这个 空格 不打也没事)

[百度一下，你就知道][度娘]
[知乎-有问题，就会有答案][知乎]

<!-- 这里是变量区域 -->
[度娘]: http://www.baidu.com 
[知乎]: https://www.zhihu.com

示范

百度一下，你就知道

知乎-有问题，就会有答案

10.2 脚注

脚注的格式：
- 在需要脚注的地方，输入：
  - [^脚注代号] ( 脚注代号会直接显示在渲染界面 )
    - 脚注代号可以随便命名，不过推荐使用 数字序号
- 在其他区域，输入：
  - [^脚注代号] + : +空格 + 脚注内容（这个 空格 不打也没事)

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

<!-- 这里是变量区域 -->
[^1]: 周树人
[^2]: 绍兴人

示范

鲁迅原名是什么，浙江哪里人

11. 拓展文本格式标记

Markdown 想实现更多的文本显示效果，只能依赖HTML标记实现
个人不是很推荐在 MD 中使用 HTML，不过一些简单的标记还是可以 轻度使用 的

11.1 键盘文本

键盘文本的格式：
- <kbd>键盘文本</kbd>
- <kbd>Ctrl</kbd> + <kbd>X</kbd>
效果：
- 键盘文本
- Ctrl + X ( 剪切 )
说明：
- 键盘文本也不一定非得是键盘按键，也可以作为着重文本突出显示
  - 效果： 这也算是一种着重文本的方式

11.2 放大文本

放大文本的格式：
- 这是一段普通文本
 <big>这是一段放大文本</big>
效果：
- 这是一段普通文本
  这是一段放大文本

11.3 缩小文本

缩小文本的格式：
- 这是一段普通文本
 这是一段缩小文本
效果：
- 这是一段普通文本这是一段缩小文本

11.4 多彩文本

多彩文本的格式：
- 这是一段橘色文本
多彩加粗文本：
- 只需要在上面示例的基础上，为里面的文本内容加上 加粗标识符
 - 格式： **这是一段加粗的水鸭色文本**
 - color 里的颜色支持英文单词，16进制，rgb ，rgba
- 在部分编辑器中(例如Obsidian)，MD与HTML的混搭会导致 样式失效 ，可以使用纯HTML标记
 - 格式： 这是一段加粗的水鸭色文本 (标记略复杂，不是很推荐)
！注意： 多彩文本尽量慎用，Markdown 的核心就是 简洁精炼，注重 实质内容，而非花哨的颜色样式

12. 拓展文本显示效果

拓展显示效果既不是原生 Markdown语法 支持的，也非 HTML标记，而是部分编辑器提供的 额外标识符，属于拓展语法，旨在为 Markdown使用者 提供更多样式选择
不同编辑器，支持不一样，这里以 Typora编辑器 为例

12.1 文本高亮

文本高亮的格式：
- ==这里是一段高亮文本==
效果：
- ==这里是一段高亮文本==

12.2 上标

用一对 ^ 包裹 (Shift+ 6)
- 格式： x^2^
- 效果： x^2^
Obsidian 没效果的，可以用后面会讲的 Latex
或者，也可以使用 HTML标记
- 这里是上标内容
- X2
效果：
- X2

12.3 下标

用一对 ~ 包裹 (Shift + `)
- 格式： H~2~O
- 效果： H~2~O
Obsidian 没效果的，可以用后面会讲的 Latex
或者，也可以使用 HTML标记
- 这里是下标内容
- H2O
效果：
- H2O

12.4 Emoji 符号

用一对 : 包裹，里面是 Emoji 符号的 语义化文本 ( Typora编辑器 中，输入 : 就会带提示器 )
- 示例：
  - :smile:
    :sweat:
    :cat:
    :woman_cartwheeling:
- 效果：
  - 补充：
    - 不支持上述方式的 MD编辑器或笔记软件，直接用 输入法 输入也是可以的
    - Windows系统 用户 win + . 就可以输入 Emoji 了

13. 转义字符

在 Markdown 中，我们通过 标识符 改变 文本显示效果
现在我们希望它不作为标识符，而是 作为字符本身呈现出来 （不具备改变文本显示效果的功能，只是一个普通字符)
- 首先我们可以用前面介绍的 代码域 ，因为代码模式的显示效果就是源代码完全一致的
- 还有一种方法，可以利用转义字符，在这些标识符前面加上 反斜线 </kbd> ( 反斜线要紧贴在标识符前面，不能有 空格 )
 - 原理：
 - \ 的作用是让标识符转义变为一个普通字符，完成这个效果后，反斜线会自动隐藏
 - 隐藏后的反斜线仅在源代码界面可见，在渲染界面不可见
 - 反斜线只争对标识符起作用，其他字符添加 \，\ 不会自动隐藏
 - 补充：
 - 如果想给已经被加在标识符前面，会自动隐藏的 \ 显示出来，可以在反斜线前面再加一个 </kbd> ，用它自己来转义自己
 - 示例： 这里紧跟在标识符前面的反斜线 \\*会被转义成普通字符显示出来，不会自动隐藏
 - 效果： 这里紧跟在标识符前面的反斜线 *会被转义成普通字符显示出来，不会自动隐藏

例1

如何让被一对或多对 * 号包裹的文本内容，能够正常显示 * ，且文本不改变格式
- \*这段文本被一对星号包裹，但不会倾斜\*
  - 效果： 这段文本被1对星号包裹，但不会倾斜
- \*\*这段文本被2对星号包裹，但不会加粗\*\*
  - 效果： 这段文本被2对星号包裹，但不会加粗
- \*\*\*这段文本被3对星号包裹，但它既不倾斜也不加粗\*\*\*
  - 效果： 这段文本被3对星号包裹，但它既不倾斜也不加粗

例2

在表格中，使用 | 作为单元格的内容，但不会被识别为表格的结构，不会增加额外的单元格

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

效果：

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

例3

在行内代码中，让反撇号 ` 能被显示出来，有两种方法
1. 首尾用两个引号包裹
 `显示2个反撇号` ， `显示单个反撇号
- 效果： 显示两个反撇号 ， ``显示单个反撇号`
- 注意： 中间的内容距离首尾引号各有1个空格
1. 之前提过，行内代码也可作为突出显示的文本
 可以利用前面介绍的键盘文本 + 转义符号 \ ，突出显示反撇号
- 格式： <kbd>\首尾的反撇号会正常显示``
- 效果： 首尾的反撇号会正常显示

例4

在 网页链接 的 显示文本内容 中，使用 中括号 [ ]

在显示文本内容中，在其中一个中括号前面，加上转义符号 反斜杠 </kbd>
- 格式： [链接里的 \[中括号\] 能被正常显示](https://www.runoob.com)
- 效果： 链接里的 [中括号] 能被正常显示

例5

引用一段话，一般会在换行之后，加上 - 出处
因为 - 是标识符，会变成一个无序列表

如下所示：

The Web, the Tree, and the String.
写作之难，在于把网状的思考，用树状结构，体现在线性展开的语句里。

史蒂芬·平克

解决方法：
- 在 - 前面加上转义符号 </kbd>

>The Web, the Tree, and the String.
>写作之难，在于把网状的思考，用树状结构，体现在线性展开的语句里。
>\- 史蒂芬·平克   <!-- 加上转义符号 \ , 不会变成无序列表 -->

效果：

The Web, the Tree, and the String.
写作之难，在于把网状的思考，用树状结构，体现在线性展开的语句里。

史蒂芬·平克

14. 空格&换行&强制删除

14.1 空格

在一些编辑器或者支持MD的笔记软件里，无论你打多少个空格，它只会显示单个空格的距离
- 可以使用 HTML中空格的 字符实体 ——  
- 若要添加多个空格，就输入多个 ——        
格式：
- 这里有      6个空格分隔
效果：
- 这里有 6个空格分隔

14.2 换行

场景1：

在一些编辑器或者支持MD的笔记软件里，无论你打多少个回车，它只会显示单个回车的空行间距
- 可以使用之前表格里提到的   标签，在 单独一行 中使用，增加额外的空行间距
- 如果要增加多个，就输入多个 ——  
- 注意： 当单独一行使用   标签的时候，如果前后有标题标识符或者列表标识符，确保 br标签 前后两行都是空白行
格式：

这里第一段文本

<br><br><br><br><br>     <!-- 这里插入了5个空行间距 -->

这里是第二段文本

效果：

这里第一段文本

这里是第二段文本

场景2：

在列表中也可以插入换行符

- 这是一段无序列表
  <br>     <!-- 插入一个空行间距，需单独一行，上下不用预留空格 -->
  这是同一段无序列表中，空一行距离显示的内容
- 这是第二段无序列表

效果：

这是第一段无序列表

这是同一段无序列表中，空一行距离显示的内容

这是第二段无序列表
补充：
- 有一些MD编辑器或笔记软件，严格遵循MD的换行规则，你敲一个回车是没法换行的，必须在行末敲 2个空格，再按回车键
  - 格式：
    - 这里是一段想换行的文本空格 空格 Enter
      这是换行后的文本

14.3 强制删除

很多编辑器都有英文标点自动补全功能，自动生成一对，光标落在中间
只想删除前面1个，却会把 一整对 都删掉
在多个列表的嵌套中，也许会遇到一些 无法被删除 的 列表标识符
解决方法：
使用 Shift + Backspace 即可强制删除
- Bcakspace ( 退格键 )

15. 嵌入

嵌入都是依赖 HTML标签 实现的

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.30"></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标签 除了嵌入页面，也可以嵌入在线视频，主流的视频网站都会提供嵌入代码
- 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 一样

16. Latex

Latex 主要用来书写 数学公式 与 化学公式

16.1 行内公式

格式：
- </kbd>** + 行内公式 + **<kbd>
示例：
- $x^2 + 2x + 5 + \sqrt x = 0$
- $\ce{CO2 + C -> 2 CO}$
效果：

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}
$

效果：

补充：
- 需要详细教程的，可戳下方链接
- Latex详细教程

17. Mermaid

一些 MD编辑器 和 笔记软件 支持通过 Mermaid 及其所提供的编译器来为用户提供图表的绘制功能
这里只提供一些演示的图表，具体教程可戳下方链接
- Mermaid详细教程

17.1 流程图

源码：

```mermaid
graph LR
emperor((朱八八))-.子.->朱五四-.子.->朱四九-.子.->朱百六
朱雄英--长子-->朱标--长子-->emperor
emperor2((朱允炆))--次子-->朱标
朱樉--次子-->emperor
朱棡--三子-->emperor
emperor3((朱棣))--四子-->emperor
emperor4((朱高炽))--长子-->emperor3


**渲染：**

![mermaid 流程图](upload://4aXq7LNVdSWCvamC0fVAPssES4w)

### 17.2 饼图

* **源码：**

pie
    title 为什么总是宅在家里？
    "喜欢宅" : 45
    "天气太热" : 70
    "穷" : 500
	"关你屁事" : 95


**渲染：**

![mermaid 饼图](upload://ruYzNi36aMvqALl2lclTq4kJuRo)

### 17.3 顺序图 (时序图)

* **源码：**

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


**渲染：**

![mermaid 时序图](upload://cVDeANmz9sZwrI1oF8ppDIf2FXN)

### 17.4 甘特图

* **源码：**

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


**渲染：**

![mermaid 甘特图](upload://Ldg0wRmzOokX9ugQT0Djr8frfr)

handsome · 2024 年12 月 25 日 07:11

感谢分享

zjsn · 2024 年12 月 25 日 07:47

感谢你的分享

potter · 2024 年12 月 25 日 08:05

Latex公式效果看不到

su518 · 2024 年12 月 25 日 08:16

感谢分享

bearrf · 2024 年12 月 25 日 08:25

赞学习了，谢谢分享！

WABC · 2024 年12 月 25 日 09:35

已添加.

yxliuchn · 2024 年12 月 25 日 09:36

点个赞赞赞赞

Lampe · 2024 年12 月 25 日 10:31

感谢分享，以前学MD的时候就是看的这个教程

话题		回复	浏览量
后台自动阅读Linuxdo帖子的脚本，无需浏览器，服务器可使用，支持多账户资源荟萃	206	7763	2024 年12 月 23 日
佬们，求markdown编辑器开发调优快问快答	39	608	2024 年12 月 12 日
linuxdo 增强插件，持续更新欢迎反馈资源荟萃精华神帖	647	18637	2024 年12 月 25 日
Gmeek 超轻量级个人博客框架开源资源荟萃 GitHub	113	3865	2024 年12 月 20 日
【Fastgpt系列1】一分钱不花搭建AI自动优化生成提示词调用FLUX.1绘画，并可接入NEW API 资源荟萃 AFF , 人工智能 , 精华神帖	159	8310	2024 年12 月 19 日

MD (Markdown) 语法详细教程 obsidian 社区转载

什么是 Markdown?

Markdown 相关软件推荐

Markdown 语法

1. 标题&目录

1.1 标题

1.2 目录

2. 斜体&粗体

2.1 斜体

2.2 粗体

2.3 粗斜体 (斜粗体)

2.4 斜体包含粗体

2.5 粗体包含斜体

3. 线

3.1 水平分割线

示范

3.2 文本删除线

3.3 文本下划线

示范

4. 列表&引用

4.1 有序列表

示范

补充

4.2 无序列表

示范

4.3 引用

示范

4.4 缩进&退格

4.4.1 有序列表的缩&退

示范

4.4.2 无序列表的缩&退

示范

4.4.3 引用的缩&退

示范

4.4.4 有序&无序&引用 连续套娃

示范

4.4.5 Obsidian 的一些缩退问题

5. 网页链接与图像

5.1 网页链接

5.2 图像

示范

6. 表格

示范

6.1 表格内文本内容的换行

示范

7. 代码域

7.1 行内代码

示范

7.2 代码块

8. 任务列表（待办）

示范

示范

9. 注释

10. 变量

10.1 网页链接变量

示范

10.2 脚注

示范

11. 拓展文本格式标记

11.1 键盘文本

11.2 放大文本

11.3 缩小文本

11.4 多彩文本

12. 拓展文本显示效果

12.1 文本高亮

12.2 上标

12.3 下标

12.4 Emoji 符号

13. 转义字符

例1

例2

例3

例4

例5

14. 空格&换行&强制删除

14.1 空格

14.2 换行

14.3 强制删除

15. 嵌入

15.1 嵌入音频

4.4.4 有序&无序&引用连续套娃