目录

Markdown 常用写法大全

分割线

1
---

标题

1
2
3
4
5
6
7
# 一级标题

## 二级标题

### 三级标题

###### 六级标题

斜体文字

1
_斜体_

斜体

加粗文字

1
**加粗**

加粗

删除线

1
~~删除内容~~

删除内容

段落和换行

1
2
3
4
5
6
新一段落需要空一行

新的一段

或者在最后加上两个空格  
换行

新一段落需要空一行

新的一段

或者在最后加上两个空格
换行

列表

基本用法

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
- 列表
- 列表
- 列表

1. 列表
2. 列表
3. 列表

- [ ] 列表
- [ ] 列表
- [ ] 列表
  • 列表
  • 列表
  • 列表
  1. 列表
  2. 列表
  3. 列表
  • 列表
  • 列表
  • 列表

多级列表

1
2
3
- 一级列表
  - 二级列表
- 一级列表
  • 一级列表
    • 二级列表
  • 一级列表

列表中分段

1
2
3
- 项目一,段落一

  项目一,段落二
  • 项目一,段落一

    项目一,段落二

列表中换行

1
2
- 项目二,第一行  
  项目二,第二行
  • 项目二,第一行
    项目二,第二行

引用

基本用法

1
> 我亦飘零久,十年来,深恩负尽,死生师友。 ——顾贞观

我亦飘零久,十年来,深恩负尽,死生师友。 ——顾贞观

多级引用

1
2
3
> 引用 1
>
> > 引用 2

引用 1

引用 2

引用中分段

1
2
3
> 引用
>
> 引用

引用

引用

引用中换行

1
2
> 引用  
> 引用

引用
引用

链接

文内链接

1
2
3
4
5
这是一个文内链接的[例子](http://example.com/ "鼠标悬浮此处显示的标题")。

[这个](http://example.net/)链接在鼠标悬浮时没有标题。

[这个](/about/)链接是本地资源。

这是一个文内链接的例子

这个链接在鼠标悬浮时没有标题。

这个链接是本地资源。

引用链接

1
2
3
这是一个引用链接的[例子][id]。

[id]: http://example.com/ "鼠标悬浮标题"

这是一个引用链接的例子

注意,这里的 id 没有大小写区分,如果省略 id,则前面方括号的内容会被用作 id。

1
2
3
4
5
我常用的网站包括[Google][1],[Yahoo][]和[MSN][]。

[1]: http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"

我常用的网站包括GoogleYahooMSN

图片

基本用法

1
![mountain](./mountain.jpeg "图片下方描述")

./mountain.jpeg
图片下方描述

base64 图片数据

1
2
3
![mountain][base64str]

[base64str]: data:image/jpg;base64,xxxxxxxxxxxxxxx... "图片下方描述"

data:image/jpg;base64,xxxxxxxxxxxxxxx...
图片下方描述

代码块

1
2
3
```python
print('Hello,World')
```
1
print('Hello,World')

链接

1
<https://www.baidu.com/>

https://www.baidu.com/

转义

在不希望符号被当成 markdown 标识符时,用\转义

1
\_不是斜体\_

_不是斜体_

Karmdowm 扩展

表格

1
2
3
4
| 左对齐 | 中间对齐 | 右对齐 |
| :----- | :------: | -----: |
| 左 1   |   中 1   |   右 1 |
| 左 2   |   中 2   |   右 3 |
左对齐中间对齐右对齐
左 1中 1右 1
左 2中 2右 3

脚注

1
2
3
4
5
6
7
请参阅脚注 1. [^1]

[^1]: 脚注 1 内容。 # 出现在文末

请参阅脚注 2. [^2]

[^2]: 脚注 2 内容。 # 出现在文末

HTML 扩展

下划线

1
<u>下划内容</u>

下划内容

上标

1
S = πr<sup>2</sup>

S = πr2

下标

1
Water: H<sub>2</sub>O

Water: H2O

首行缩进

1
&emsp;&emsp;开始内容

  开始内容

内部跳转

1
2
3
点此[标签](#j1)跳转。

<a name="锚点" id="j1" href="https://saltfishpr.github.io/"></a>

点此标签跳转。

id 要匹配, namehref 都不是必须的

插入视频

1
2
3
4
5
6
7
8
<div>
  <a href="//player.bilibili.com/player.html?aid=93178052&cid=159088790&page=1" target="_blank"><img src="封面图片路径" alt="没有图片时显示此文字"  width="100%" frameborder="no" framespacing="0" allowfullscreen="true" /></a>
  <script>
    var em = document.getElementById("video-iframe");
    console.log(em.clientWidth);
    em.height = em.clientWidth * 0.75
  </script>
</div>
没有图片时显示此文字

注释

1
[^_^]: # (注释,不会在浏览器中显示。)
1
2
3
<div style='display: none'>
注释内容
</div>
注释内容
1
2
3
4
5
<!--
多段
注释,
不会在浏览器中显示。
-->

short code

person

1
{{< person url="https://saltfishpr.github.io/about/" name="硕" nick="saltfishpr" picture="https://github.com/saltfishpr.png" >}}
saltfishpr (saltfishpr)

参考资料

  1. https://www.jianshu.com/p/d7d6da4b7c60#fnref1
  2. https://guides.github.com/features/mastering-markdown/
  3. emoji 目录