简述
本文介绍的markdown语法,只是本人自己平时写博客时常用的,还有许多没有写的,请自行查找,在这里感到抱歉。
标题
Markdown 支持两种标题的语法,类Setext和类atx形式。
类Setext形式是用底线形式,利用 =(最高阶标题)和 -(第二阶标题),例如
这是个H1标题
============
这是个H2标题
------------
类atx形式是在行首插入1到6个 #号,对应到标题1到6阶,例如:
# 这是H1 #
## 这是H2 ##
### 这是H3 ###
区块引用 Blockquotes
Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。如果你还熟悉在 email
信件中的引言部分,你就知道怎么在 Markdown 文件中建立一个区块引用,那会看起来像是你自己先断好行,然后在每行的最前面加上 > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
列表
Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记:
* red
* Green
* Blue
等同于:
+ red
+ Green
+ Blue
等同于:
- red
- Green
- Blue
有序列表则使用数字接着一个英文句点:
1. Bird
2. McHale
3. Parish
代码区块
和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块,通常这些区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示,Markdown 会用 标签来把代码区块包起来。
要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如,下面的输入:
这是一个普通段落:
这是一个代码区块。
或者
```bash
这是一个代码区块
```
分割线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
* * *
***
*****
- - -
---------------------------------------
链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
不管是哪一种,链接文字都是用 [方括号] 来标记。
直接连接
隐式链接
[百度](http://baidu.com)
百度
强调
Markdown 使用星号()和底线(_)作为标记强调字词的符号,被 () 或() 包围的字词会被转成用 em 标签包围,用两个 (*) 或 () 包起来的话,则会被转成 strong,例如:
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
图片
很明显地,要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
![](/path/to/img.jpg)
![](/path/to/img.jpg "Optional title")
详细叙述如下:
- 一个惊叹号 !
- 接着一个方括号,里面放上图片的替代文字
- 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的'title' 文字。
反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用em 标签),你可以在星号的前面加上反斜杠:
\*literal asterisks\*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
- 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
* 加号
+ 减号
. 英文句点
! 惊叹号
本文参考地址:http://wowubuntu.com/markdown/index.html
原文: http://blog.hawkzz.com/2017/04/22/Markdown常用语法/ 作者: hawk_zz