Markdown语法小结

随着国内自媒体的盛行,如何低成本高效的实现排版成为摆在所有自媒体人面前的一道重要的关卡。此时,Markdown语法从小众开始进入大众视野。Markdown可以理解为一种简化的html语法,其语法特性决定了其天然兼容html语法,易读,易写,已修改,跨平台,高自由度等等特性都使其成为个人文章排版的最优选择。

1. Markdown 是什么

Markdown是一种轻量级标记语言,它以纯文本形式(易读、易写、易更改)编写文档,并最终以HTML格式发布。Markdown也可以理解为将以MARKDOWN语法编写的语言转换成HTML内容的工具。

2. 基础语法

基础的Markdown语法主要包含:标题,段落,加粗倾斜,分割线删除线,引用,代码块,列表,链接,图片

标题

一般标题可以分为一级标题,二级标题,三级标题……

  1. 使用=-标记一级和二级标题。

一级标题 ===== 二级标题 -

  1. 可以通过添加#表示标题,#数目表示标题等级,最多六级

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

:一般博客从二级标题开始,一级标题过大

段落

段落的前后要有空行,所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车(引用中换行省略回车)。

加粗倾斜分割线删除线

在内容两侧分别加上*或者_,如:

*斜体*_斜体_

**加粗**__加粗__

分割线最常使用就是三个或以上-,还可以使用*_。删除线则是句子前后加两个波浪号~~

效果:

斜体

粗体

删除线


引用

在段落的每行或者只在第一行使用符号>,还可使用多个嵌套引用,如:

> 区块引用

>> 嵌套引用

效果:

引用

嵌套引用

代码块

代码区块的建立是在每行加上4个空格或者一个制表符(如同写代码一样),注意要和普通段落间存在空行,最常用围墙式代码块,即使用 3 个连续的反单引号把一段文字包围起来表示代码块,这样可以避免每行代码开头都添加 4 个空格。使用围墙式代码块还有有个额外的功能:可以指定编程语言类别,让其中的代码实现语法高亮,方法是在第一行反单引号后面写上语言种类的名称。如

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

​```C

void main()

{

printf("Hello, World");

}

​```

注意:需要和普通段落之间存在空行。

行内也可以对较短的字符标记代码,方法是使用两个返单引号,如:

1
2

行内`短`代码

列表

使用·、+、或-标记无序列表,符号后需添加一个空格才能继续书写文字

使用数字并辅以.标记有序列表

- 第一项 + 第一项 . 第一项 1. 第一项 1. 第二项

对应效果为:

  • 第一项
  • 第一项 . 第一项
  1. 第一项
  2. 第二项

超链接

链接的形式有两种:行内式和参考式

行内式语法为

1
2

[百度](https://www.baidu.com/)

参考式语法为

1
2
3
4
5
6
7
8

[百度][1]

[京东][2]

[1]:https://www.baidu.com/

[2]:https://www.jd.com/

效果为:

百度

京东

图片

添加图片的形式和链接相似,只需在链接的基础上前方加一个!

1
2

![Aaron Swartz](https://laregledujeu.org/files/2013/01/Aaron_Swartz.jpg)

3. 扩展语法

扩展语法可以实现一些比较特殊的需求,但是不是所有的markdown编辑器都支持,所以在使用中需要注意兼容性。

待办事项

语法为:- [ ]表示未完成事项,- [X]表示已经完成事项

效果:

  • 待办
  • 已完成

转义字符

Markdown中使用多种符号代表不同含义,如果要输入这些符号怎么办呢?此时就要使用到转义字符,他的作为是让语法符号变为普通符号。转义字符为反斜杠\

表格

不同编辑器渲染的表格样式是不同的,支持力度也不同,譬如我非常喜欢的笔记软件 notion ,虽然支持部分Markdown语法,但是会将表格自动转化为database,导致在逆向输出的时候无法还原为Markdown表格。

具体语法为使用|表示纵向边界,表头和内容使用-分隔开,使用:进行对齐操作,两侧都有表示居中对齐,不加默认左对齐。

1
2
3
|表头左对齐|表头右对齐|表头居中对齐|
|-|:-:|-:|
|内容左|内容右|内容中|

效果:

表头左对齐表头右对齐表头居中对齐
内容左内容右内容中

缩进

修改代码块缩进方法通用,都是选择要缩进代码,使用Tab 键增加缩进,按 Shift + Tab 键减少缩进。

还可以使用的缩进方法

  1. 使用表示空格的特殊字符  
  2. 输入法半角改全角,然后连续键入两个空格(半角改全角的快捷键为Shift+Space

数学公式

公式的语法规则基本和Latex相同,可参见常用数学符号的 LaTeX 表示方法

主要也分为行内和区块两种,行内公式使用单个美元符$包围,区块使用两个美元符,比如

1
2
3
4
5
$2^2$

$$
\frac{2}{3}
$$

效果如下(要看渲染引擎是否支持)

$2^2$

$$ \frac{2}{3} $$

特殊字符

不论是对公式的编辑,还是平时的使用,经常会遇到一些数学符号、希腊字母等特殊的字符,这些字符可以直接键入其命名实体或十进制代码而无需转义符\包含就能显示,一个简单的例子如下。

1
2
3
字符:希腊字母阿尔法
命名实体表示:Φ
十进制编码表示:Φ

效果为 &#934

4. Html 语法

由于markdown最终还是要转换成HTML页面,所以实际上可以使用一些HTML的语法来辅助书写

插入空行

使用</br>可以替代作为空行插入

文字居中

写法如下

1
<center>这一行需要居中</center>

效果如下

这一行需要居中

上下标

写法如下

1
2
H<sub>2</sub>O
爆米<sup>TM</sup>  

效果

H2O 爆米TM

字体颜色与字号

写法如下

1
2
3
<font color="#FF0000"> 红色 </font>
<font size=6> size=6 </font>
<font size=5 color="#FF0000"> size=5的红色</font>

效果如下

红色 size=6 size=5的红色

图片

原始图片规格不一,展示出来的效果往往很不好,使用HTML的语法可以定制图片的某些属性。以上面的创始人Aaron Swartz的图片为例,我们控制其大小

1
<img src="https://laregledujeu.org/files/2013/01/Aaron_Swartz.jpg" width="512" height="384" />

通过将多张图片放在一个一行多列的表格中,线宽设置为0, 可以让这些图片并排显示,代码如下

1
2
3
4
<table><tr>
<td><img src="http://bimgs.plmeizi.com/images/bing/2019/OHR.BeaujolaisRegion_ZH-CN1585928268_1920x1080.jpg" alt="风景1" style="zoom: 67%;" /></td>
<td><img src="http://bimgs.plmeizi.com/images/bing/2020/OHR.MalhamStars_ZH-CN4163177154_1920x1080.jpg" alt="风景2" style="zoom: 67%;" /></td>
</tr></table>

页内跳转

先定义一个锚

1
<span id="jump">Hello World</span>

然后使用markdown语法即可跳转到锚所在之处

1
[XXXX](#jump)

附录:特殊字符对照

普通字符

特殊符号命名实体十进制编码
空格&nbsp;&#160;
全角空格&emsp;&#12288;
&apos;&#39;
"&quot;&#34;
(&#40;
)&#41;
<&lt;&#60;
>&gt;&#62;
[&#91;
]&#93;
{&#123;
}&#125;
´&acute;&#180;
°&deg;&#176;
®&reg;&#174;
©&copy;&#169;

数学符号

特殊符号命名实体十进制编码
&le;&#8804;
&ge;&#8805;
&asymp;&#8773;
&ne;&#8800;
&cap;&#8745;
&cup;&#8746;
&ang;&#8736;
&infin;&#8734;
±&plusmn;&#177;
&radic;&#8730;
&sum;&#8722;
&int;&#8747;
Δ&Delta;&#916;

希腊字母

特殊符号命名实体十进制编码
Φ&Phi;&#934;
Ω&Omega;&#937;
α&alpha;&#945;
β&beta;&#946;
γ&gamma;&#947;
δ&delta;&#948;
ε&epsilon;&#949;
ζ&zeta;&#950;
η&eta;&#951;
θ&theta;&#952;
λ&lambda;&#955;
μ&mu;&#956;
ξ&xi;&#958;
π&pi;&#960;
ρ&rho;&#961;
σ&sigma;&#963;
φ&phi;&#966;
ψ&psi;&#968;
ω&omega;&#969;
&part;&#8706;
&empty;&#8709;
0%