磁头笔记:Markdown语法速查表

Markdown 备忘清单

Markdown是什么?

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

谁创造了它?

它由Aaron Swartz和John Gruber共同设计,Aaron Swartz就是那位于去年(2013年1月11日)自杀,有着开挂一般人生经历的程序员。维基百科对他的介绍是:软件工程师、作家、政治组织者、互联网活动家、维基百科人。

他有着足以让你跪拜的人生经历:

  • 14岁参与RSS 1.0规格标准的制订。
  • 2004年入读斯坦福,之后退学。
  • 2005年创建Infogami,之后与Reddit合并成为其合伙人。
  • 2010年创立求进会(Demand Progress),积极参与禁止网络盗版法案(SOPA)活动,最终该提案被撤回。
  • 2011年7月19日,因被控从MIT和JSTOR下载480万篇学术论文并以免费形式上传于网络被捕。
  • 2013年1月自杀身亡。

为什么要使用它?

  • 它是易读(看起来舒服)、易写(语法简单)、易更改纯文本。处处体现着极简主义的影子。
  • 兼容HTML,可以转换为HTML格式发布。
  • 跨平台使用。
  • 越来越多的网站支持Markdown。
  • 更方便清晰地组织你的电子邮件。(Markdown-here, Airmail)
  • 摆脱Word(我不是认真的)。

怎么使用?

如果不算扩展,Markdown的语法绝对简单到让你爱不释手。

Markdown语法主要分为如下几大部分: 标题,段落,区块引用,代码区块,强调,列表,分割线,链接,图片,反斜杠 \,符号’`’。

基础语法

标题 (atx 风格)

1
2
3
4
5
6
# h1
## h2
### h3
#### h4
##### h5
###### h6

标题 (setext 风格)

1
2
3
4
Header 1
========
Header 2
--------

块引用

1
2
3
4
5
> 这是一个
> 块引用
>
> > 嵌套
> > 块引用

无序列表

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
* Item 1
* Item 2
* item 3a
* item 3b
或者

- Item 1
- Item 2
或者

+ Item 1
+ Item 2
或者任务列表

- [ ] Checkbox off
- [x] Checkbox on

有序列表

1
2
3
4
1. Item 1
2. Item 2
a. item 3a
b. item 3b

链接

1
2
3
4
5
6
[link](http://google.com)

[link][google]
[google]: http://google.com

<http://google.com>

强调

1
2
3
*斜体*    _斜体_    **粗体**   __粗体__

`内联代码` ~~删除~~

水平线

1
2
3
4
5
6
7
8
9
10
连字符

---

星号

***

下划线
___

换行

1
2
3
4
在当前行的结尾加 2 个空格··
这行就会新起一行\
反斜杠也可以换行
尾部添加两个空格,或者添加 \ 反斜杠

表格

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
| 左栏     | 中间栏   | 右栏  |
| -------- | -------- | ----- |
| 单元格 1 | 居中 | $1600 |
| 单元格 2 | 单元格 3 | $12 |
简单的风格

左栏 | 中间栏 | 右栏
-------- | -------- | -----
单元格 1 | 居中 | $1600
单元格 2 | 单元格 3 | $12
增加 : 改变文字对齐方式

左栏 | 中间栏 | 右栏
:------- | :------: | -----:
左对齐 | 居中 | 右对齐

Markdown 表格生成器:tableconvert.com

脚注 (Footnotes)

1
2
3
这是一个简单的脚注[^1]

[^1]:我的参考。

图片

1
2
3
![图片名称](http://图片网址/images/logo.png)
![替代文字](url)

带链接的图片

1
2
[![GitHub Logo](/images/logo.png)](https://github.com/)
[![替代文字](image_url)](link_url)

行内 HTML 元素

1
目前只支持部分段内 HTML 元素效果,包括 <kbd>, <b>, <i>, <em>, <sup>, <sub>, <br>

反斜杠转义

1
2
3
4
5
6
7
8
9
10
11
12
\	\\	backslash 反斜杠
` \` backtick 反引号
* \* asterisk 星号
_ \_ underscore 下划线
{} \{} curly braces 花括号
[] \[] square brackets 方括号
() \() parentheses 圆括号
# \# hash mark 哈希标记
+ \+ plus sign 加号
- \- minus sign (hyphen) 减号(连字符)
. \. dot 点
! \! exclamation mark 感叹号

另见:GitHub风格的Markdown规范


磁头笔记:Markdown语法速查表
https://blog.luluvip.cn/2024/05/27/markdown语法速查表/
作者
Sagit.
发布于
2024年5月27日
许可协议