Markdown常用语法总结

Posted on | In | 阅读

Markdown 是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。它允许人们“使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML(或者HTML)文档”。[4]这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

个人使用markdown编写博客的编辑器是Typora，它不像传统编辑器那样并排展示，而是一个即时渲染的编辑器，所见即所得，让习惯word编辑的人编辑markdown更加的方便。至于好不好用就见仁见智了。毕竟有的人喜欢Jetbrain，而有的人以用Vim为荣。

换行

在行尾添加两个空格加回车表示换行：

如果使用Typora则不用担心此问题，换行时会自动加两个空格

标题

1、用#标记

在 标题开头 #，加几个就代表是几级标题

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

2、用=和-标记

在 标题底下 加上任意个=代表一级标题，-代表二级标题

1
2
3
4
5
一级标题
======

二级标题
------

效果：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

######

列表

无序列表

*后面加一个空格：

1
2
3
* 无序列表项目
* 无序列表项目
* 无序列表项目

效果（-和+是一样的）：

  • 无序列表项目
  • 无序列表项目
  • 无序列表项目

有序列表则

数字加英文句点.：

1
2
3
1. 有序列表项1
2. 有序列表项2
3. 有序列表项3

效果如下：

  1. 有序列表项1
  2. 有序列表项2
  3. 有序列表项3

代码

代码分为行内代码和代码块。

  • 行内代码使用 一个`符号标识 ，可嵌入文字中

  • 代码块使用```标识（还有一种4个空格的不推荐，会和缩进弄混）

    ```
    这里是代码
    ```

  • 代码语法高亮在 ```后面加上 空格和语言名称即可

    ``` 语言
    这里是代码
    ```

例如：

`这是一段高亮代码`

``` c++

long long multi(long long a, long long b, long long mod)
{

long long ret = 1;
while(b > 0)
{
​ if(b & 1)
​ ret = (reta)%mod;
​ a = (a a) % mod;
​ b /= 2;
}
return ret;

}//pow(a, b) mod m

```

效果:

这是一段高亮代码

1
2
3
4
5
6
7
8
9
10
11
12
long long multi(long long a, long long b, long long mod)
{
    long long ret = 1;
    while(b > 0)
    {
        if(b & 1)
            ret = (ret*a)%mod;
        a = (a * a) % mod;
        b /= 2;
    }
    return ret;
}//pow(a, b) mod m

分隔线

在一行中用三个以上的*、-、_来建立一个分隔线，行内不能有其他东西。也可以在符号间插入空格。

1
2
3
4
5
***
---
___

* * *

效果均为一条分割线：

引用

引用以>加空格来表示，引用中支持多级引用，引用中的常用语法不会受到影响。

常见的引用写法：

1
2
3
4
5
> 这是一段引用

> 一级引用
> > 二级引用
> > > 三级引用

效果：

这是一段引用

一级引用

二级引用

三级引用

强调

两个*或-代表加粗，一个*或-代表斜体，~~已删除的横线。

1
2
3
4
5
**加粗** or __加粗__

*斜体*  or _斜体_

~~横线~~

效果：

加粗 or 加粗

斜体 or _斜体_

横线

图片&链接

图片有一个 ! 号，链接没有，而在Typora中可以直接插入图片：

1
2
图片：![image description](url) 
链接：[link description](url)

链接以及图片又分为行内式、参考式和 自动链接 上面的格式就是行内式。一般我使用行内式，使用参考室只是方便更新图片：

1
2
3
4
5
6
链接行内式：[Ph0en1x Notebook](https://ph0en1xgseek.github.io/)。

自动链接：<https://ph0en1xgseek.github.io/>

图片参考式：![typora][1]
[1]: https://typora.io/img/new/lists.png

效果如下：

链接行内式：Ph0en1x Notebook。

自动链接：https://ph0en1xgseek.github.io/

图片参考式：![typora][1]
[1]: https://typora.io/img/new/lists.png

表格

表格对齐格式，Typora中也可以直接插入表格

  • 左对齐：:----
  • 中线对齐：:----:或-----
  • 右对齐：----:

例子：

1
2
3
4
5
6
|标题|标题|标题|
|:---|:---:|---:|
|左对齐|中线对齐|右对齐|
|左对齐|中线对齐|右对齐|
|左对齐|中线对齐|右对齐|
|左对齐|中线对齐|右对齐|

效果：

标题 标题 标题
左对齐 中线对齐 右对齐
左对齐 中线对齐 右对齐
左对齐 中线对齐 右对齐
左对齐 中线对齐 右对齐

脚注

[^]来定义脚注：

1
2
3
Ph0en1x Notebook[^1]

[^1]: https://ph0en1xgseek.github.io/

效果：

Ph0en1x Notebook^1