手把手教你Markdown语法-CFANZ编程社区

1、Markdown 标题

Markdown里有六种标题，均为若干个 # 加空格组成。

Markdown的“标记符”多由“标点符号+空格”组成。该写空格就写，别忘了。

一级标题（最大字号）对应一个 # 号，二级标题对应两个 # 号，以此类推，可实现1-6个级别的标题。

# 后边需要追加一个空格，空格后边即为标题内容。

注：标题应为独立的一行，并且其上、下应各为一个空白行。

语法示例：

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

Tips：日常使用 3 - 5 号标题即可。

渲染效果：

你好

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2、Markdown 段落

Markdown不同于常规的Word文档，空白行是“切换段落”（分段）用的，并不会渲染成“空行”。因此，在段落后面使用一个空行，以表示重新开始一个段落（推荐）。

也可以在段尾使用“两个以上空格加回车”来实现切换段落（不推荐）。

语法示例1（不分段，仅换行）：

我希望有个如你一般的人，如山间清爽的风，如古城温暖的光。
从清晨到夜晚，由山野到书房。只要最后是你，就好。

渲染效果1：

我希望有个如你一般的人，如山间清爽的风，如古城温暖的光。
从清晨到夜晚，由山野到书房。只要最后是你，就好。

语法示例2（进行分段）：

我希望有个如你一般的人，如山间清爽的风，如古城温暖的光。

从清晨到夜晚，由山野到书房。只要最后是你，就好。

渲染效果2：

我希望有个如你一般的人，如山间清爽的风，如古城温暖的光。

从清晨到夜晚，由山野到书房。只要最后是你，就好。

3、Markdown 斜/粗体

文字倾斜：

方法1：用 * （或 _ ）左右包起来即可（推荐）。

方法2：用HTML标签   来实现（不推荐）。

文字加粗：

方法1：用俩 * （或 _ ）左右包起来即可（推荐）。

方法2：也可以用HTML标签   或   来实现（不推荐）。

斜粗体文字：

用仨 * （或 _ ）左右包起来即可。

示例文本：

*斜体文本*

_斜体文本_

<i>HTML斜体文本</i>

**粗体文本**

__粗体文本__

<b>HTML加粗内容示例</b>

<strong>HTML加粗文字</strong>

***粗斜体文本***

___粗斜体文本___

渲染效果：

斜体文本

粗体文本

加粗内容示例

加粗文字

粗斜体文本

4、Markdown 字号/颜色

如果你想指定字号/颜色，可以尝试用html里的   标签来实现。

正常情况下，字号3应最接近默认大小，颜色采用6位16进制数，由前至后分别代表红绿蓝，每种颜色用2位16进制数表示，最终字体颜色效果为RGB的混合色。

示例文本：

<font size="3">三号文字</font>

<font size="4">四号文字</font>

<font size="5" color="#FF0000">五号红字</font>

<font color="#FF0000">红色文字</font>

<font color="#FFA500">橙色文字</font>

<font color="#FFFF00">黄色文字</font>

<font color="#00FF00">绿色文字</font>

<font color="#00FFFF">青色文字</font>

<font color="#0000FF">蓝色文字</font>

<font color="#A020F0">紫色文字</font>

<font color="#FFC0CB">粉色文字</font>

<font color="#A52A2A">棕色文字</font>

渲染效果：

三号文字

四号文字

五号红字

红色文字

橙色文字

黄色文字

绿色文字

青色文字

蓝色文字

紫色文字

粉色文字

棕色文字

对于解析 font 标签中 size 的值，Typora只取出了整数部分。

简记工具提供了快捷键“彩色文字标签”，但这并非最佳方案。下边贴几个常用的标签吧。

橙色文字：

<font color="#FF7F00"></font>

渲染示例：橙色文字

蓝色文字：

<font color="#0000ff"></font>

渲染示例：蓝色文字

四号字：

<font size="4"></font>

渲染效果：

四号字

5、Markdown 微调字号

这个很少有人在Markdown教程里讲到，需要的时候用一下也不错。

借助HTML标签big/small，即可微调文字大小。

语法示例：

<big>大号文字</big>

<small>小号文字</small>

渲染效果：

大号文字

小号文字

ChaTi额外扩充了large标签，以方便微调更大字号，语法示例：

<large>字号增大</large>

注： large 标签仅在ChaTi/轻记内生效，其他任何编辑器都不支持该标签，请谨慎使用。

6、Markdown 删除线

用俩 ~ 左右包起来即可，也可以用HTML的 <s> </s> 标签来实现（不推荐）。

语法示例：

~~Markdown 删除线内容~~

<s>删除线内容</s>

渲染效果：

~~Markdown 删除线内容~~

~~删除线内容~~

7、Markdown 下划线

Markdown本身并不提供下划线标签，需要借助HTML的   标签。

语法示例：

<u>下划线文字</u>

渲染效果：

下划线文字

8、Markdown 无序列表

无序列表是一个项目的列表，此列项目使用粗体圆点进行标记。

Markdown无序列表写法非常简单，减号（或加号、星号）加一个空格即可。

注：推荐使用减号，因为星号常用于斜粗体。

语法示例：

- Markdown无序列表

+ Markdown无序列表

* Markdown无序列表

渲染效果：

Markdown无序列表
Markdown无序列表
Markdown无序列表

当然啦，还可以用html的 <ul> </ul> 和 <li> </li> 标签来实现（极其复杂，不推荐）。

HTML语法示例：

<ul>
    <li>Coffee</li>
    <li>Milk</li>
</ul>

渲染效果：

Coffee
Milk

9、Markdown 有序列表

和无序列表类似，有序列表也是一列项目，列表项目使用数字进行标记。

注：相较于其他文字，列表部分会轻微向右偏移。

Markdown有序列表写法非常简单，数字加小数点，然后加一个空格即可。

语法示例：

1. Markdown有序列表
2. Markdown有序列表

渲染效果：

Markdown有序列表
Markdown有序列表
当然啦，还可以用html的<ol> </ol> 和 <li> </li> 标签来实现（极其复杂，不推荐）。

HTML语法示例：

<ol>
    <li>Coffee</li>
    <li>Milk</li>
</ol>

渲染效果：

Coffee
Milk

10、Markdown 嵌套无序列表

无序列表是可以多层嵌套的，在子层列表的行首放两个或更多个空格即可。

语法示例：

- 嵌套列表
  - 二级列表
    - 三级列表

渲染效果：

嵌套列表

二级列表

三级列表

来个复杂点的？

语法示例：

- 儒
- 释
- 道
    - 书籍
        - 道德经
    - 著名人物
        - 张道陵
        - 葛玄
        - 萨守坚
        - 许旌阳

渲染效果：

书籍

道德经

著名人物

张道陵
葛玄
萨守坚
许旌阳

当然啦，HTML的也是可以写出来的（太复杂，不推荐）。

HTML语法示例：

<ul>
    <li>儒</li>
    <li>释</li>
    <li>道
        <ul>
            <li>书籍
                <ul>
                    <li>道德经</li>
                </ul>
            </li>
            <li>著名人物
                <ul>
                    <li>张道陵</li>
                    <li>葛玄</li>
                    <li>萨守坚</li>
                    <li>许旌阳</li>
                </ul>
            </li>
        </ul>
    </li>
</ul>

渲染效果：

书籍

道德经

著名人物

张道陵
葛玄
萨守坚
许旌阳

11、Markdown 引用

Markdown中通过 > （大于号）加一个空格实现 引用 。

语法示例：

> 从你的全世界路过

渲染效果：

从你的全世界路过

进阶玩法：

引用 也可以多级嵌套（连续使用多个 >，加一个空格），而且支持和其它Markdown标签搭配使用，比如无序列表。

语法示例：

> 一级引用文本
>> 二级引用文本
>> - 二级引用，无序列表
>>> 三级引用文本
>>> * 三级引用，无序列表

渲染效果：

一级引用文本

二级引用文本

二级引用，无序列表

三级引用文本

三级引用，无序列表

12、Markdown 代码

并不一定真要放代码时才能用这个标签，这里举两个例子：

1.如果要重点突出某个字，可以用行内代码标签

2.如果不想让Markdown渲染某段文字，可以用代码块标签进行包裹

Markdown中代码格式化可以通过三种方式：

行内式：通过一对 ` 包裹单行代码/文字实现；

代码块：通过一对 ```包裹实现，可以指定代码的编程语言，如Python、JavaScript、Rust等，如果渲染器支持，将实现语法高亮；

缩进式：通过缩进至少四个空格实现，部分支持语法高亮。

前两个很常用，缩进式写起来很恶心，不推荐。

ChaTi/轻记APP，代码块支持高亮显示，支持标注以下语言：

brainf*ck , c , clike , clojure , cpp , csharp , css , dart , git , go , groovy , java , javascript , json , kotlin , latex , makefile , markdown , markup , python , scala , sql , swift , yaml

注：请使用真实的语言名称（不是别名）。所以，应用 javascript 而不是 js ，应用 markup 而不是 xml 。另外，所有语言名称一律为小写字母。

语法示例：

1.行内式代码： `import os, sys`

2.代码块（无需缩进）：

\```python
import os, sys

sys.path

print(os)
\```

3.缩进式：

    if (isAwesome){
      return true
    }

注：为避免标签渲染冲突，代码块标签前面我加了个反斜杠。

渲染效果：

1.行内式代码： import os, sys

2.代码块（无需缩进）：

import os, sys

sys.path

print(os)

3.缩进式：

if (isAwesome){
  return true
}

13、Markdown 注释

被注释的文字不会显示出来。

正是基于这个特点，衍生出了ChaTi/轻记的“一键复制”功能（后边会重点讲解）。

推荐写法：

[](注释内容，渲染时不会显示)

Markdown中注释可以通过三种方式实现：

1.HTML注释：

用  标签来实现注释；

2.HTML标签：

用HTML标签显示属性 style='display: none' 标签来实现注释；

注：要看编辑器有没有解析div标签。

3.HACK方法：

用Markdown解析原理来实现注释。

注：HACK方法基于Markdown解析原理，相较于HTML注释和HTML标签显示属性要稳定得多，但语义化差（不易阅读）。

Tips：HACK方法注释写法很灵活，基于Markdown解析原理即可。以下实例代码仅试举几例，可自由组合。

语法示例：

HTML注释 <!--...-->

<!-- 我是单行注释，渲染时不会显示。-->

<!--
我是多行，
段落注释，
渲染时不会显示。
-->

HACK方法注释（此处仅是举例，可以利用Markdown解析原理自由组合语法）。

[](我是注释，渲染时不会显示。)

[注释关键字]:(注释描述。)

[#]:<> "我是注释，渲染时不会显示。"
[#]:# "我是注释，渲染时不会显示。"
[注释]:<> "我是注释，渲染时不会显示。"
[注释]:# "我是注释，渲染时不会显示。"
[注释]:// "我是注释，渲染时不会显示。"
[//]:<> "我是注释，渲染时不会显示。"
[//]:# "我是注释，渲染时不会显示。"

渲染效果：

HTML注释

HACK方法注释（此处仅是举例，可以利用Markdown解析原理自由组合语法）。

14、Markdown 任务清单

固定写法，没必要去记，底部给了快捷复制。

语法示例：

- [ ] 未完成

- [x] 已完成

渲染效果：

15、Markdown 变量

Markdown 中支持变量定义和变量引用，且支持中文。

一处定义，处处使用，而且方便统一修改。

语法示例：

步骤1.定义链接
[百度]:https://www.baidu.com

步骤2.引用链接：
引用方式：[网站链接][百度]

渲染效果：

步骤1.定义链接[百度]:https://www.baidu.com

步骤2.引用链接：

引用方式：[自定义文本][百度]

16、Markdown 图片

格式：![Alt Text](img url)

这个不需要手写标签，可通过图床工具。

通过简记调用“插图”，即可自动复制Markdown格式的图片标签。

语法示例：

![图片文字描述](https://file.cfanz.cn/uploads/jpeg/2022/09/26/7/c6e1WMVb68.jpeg?x-oss-process=image/watermark,size_16,text_QDUxQ1RP5Y2a5a6i,color_FFFFFF,t_30,g_se,x_10,y_10,shadow_20,type_ZmFuZ3poZW5naGVpdGk=)

渲染效果：

手把手教你Markdown语法_Markdown

也支持HTML图片标签，顺便贴一下吧。

HTML语法示例：

<img src = 'https://file.cfanz.cn/uploads/jpeg/2022/09/26/7/f6C59H6J4S.jpeg?x-oss-process=image/watermark,size_16,text_QDUxQ1RP5Y2a5a6i,color_FFFFFF,t_30,g_se,x_10,y_10,shadow_20,type_ZmFuZ3poZW5naGVpdGk=' />

渲染效果：

手把手教你Markdown语法_渲染效果_02

17、Markdown 链接

有些Markdown工具不支持自动识别http开头的url链接，用<>包裹链接即可，如：

<https://xiaobeiit.cn>

渲染效果：

https://xiaobeiit.cn

若需指定url链接文本，格式：[文本](url)

语法示例：

[xiaobeiit](https://xiaobeiit.cn)

渲染效果：

xiaobeiit

18、Markdown 锚点

在纯Markdown环境下一般（自信点，去掉这俩字）是无法生效的，需要在网页内展示。如使用Typora导出为.html文件，或使用CSDN等博客平台。

语法示例：

<a href="#标记">锚点标题</a>

<a >跳转到此处</a>

渲染效果：

锚点标题

跳转到此处

19、Markdown 表格

语法示例：

| 左对齐 | 居中对齐 | 右对齐 |
| :--| :--: | --: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

渲染效果：

左对齐	居中对齐	右对齐
单元格	单元格	单元格
单元格	单元格	单元格
单元格	单元格	单元格
单元格	单元格	单元格

20、Markdown 特殊字符

语法示例：

空格符： 
小于号：<
大于号：>
和号：&
人民币：¥
版权：©
注册商标：®
摄氏度：°
正负号：±
乘号：×
除号：÷
平方（上标²）：²
立方（上标³）：³

渲染效果：

注：在空格符的上下方各插入一个空行，即可在渲染时显示空白行。

21、Markdown 对齐文字

Markdown并不提供“居中”等语法标记，需要借助HTML标签来实现。

语法示例：

center标签：

<center>居中文字</center>

align标签：

<p align=center>居中文字</p>

align标签：

<p align=right>右对齐文字</p>

渲染效果：

居中文字

右对齐文字

左对齐

22、Markdown 媒体文件

播放视频代码：

<video id="video" controls="" preload="none" poster="封面图链接"><source id="mp4" src="视频地址" type="video/mp4"></video>

播放音频代码：

<audio id="audio" controls="" preload="none"><source id="mp3" src="音频地址"></audio>

示例：

23、Markdown 联系方式

QQ聊天

Markdown和HTML的链接标签均可，uin即为QQ号。

[QQ联系](http://wpa.qq.com/msgrd?v=3&uin=1653131174&site=qq&menu=yes)

<a target="_blank" href="http://wpa.qq.com/msgrd?v=3&uin=1653131174&site=qq&menu=yes">QQ联系</a>