Markdown语法及示例

1.标题语法:

Markdown 支持两种标题的语法,Setext形式和Atx形式
Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题)

例如:
A First Level Header
====================
A Second Level Header
---------------------

A First Level Header

A Second Level Header

Atx 形式在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶。

例如:
#一级标题
##二级标题
###三级标题
####四级标题
#####五级标题
######六级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

</br>
2.引用
========
区块引用则使用 email 形式的 '>' 角括号。

例如:
> 引用
> 
>>引用中的引用
>
> ## 引用中的标题

引用

引用中的引用

引用中的标题

3.修辞和强调

Markdown 使用星号和底线来标记需要强调的区段。单标记表示斜体,双标记表示粗体

例如:
使用单星号: *星号斜体*
使用单下划线: _下划线斜体_
使用双星号: **星号粗体**
使用双下划线: __下划线粗体__

使用单星号: 星号斜体
使用单下划线: 下划线斜体

使用双星号: 星号粗体
使用双下划线: 下划线粗体
删除线:使用双波浪包含表示文字被添加删除线

~~删除线~~

删除线
4.列表
===
无序列表:使用星号、加号和减号来做为列表的项目标记

星号:
* Candy.
* Gum.
* Booze.
  • Candy.
  • Gum.
  • Booze.
加号:
+ Candy.
+ Gum.
+ Booze.
  • Candy.
  • Gum.
  • Booze.
减号:
- Candy.
- Gum.
- Booze.
  • Candy.
  • Gum.
  • Booze.

有序列表:使用一般的数字接着一个英文句点作为项目标记,数字不能省略但可无序,点号之后的空格不能少

1. Red
4. Green
3. Blue
  1. Red
  2. Green
  3. Blue

嵌套列表:
-+*可循环使用,但符号之后的空格不能少,符号之前的空格也不能少

- 嵌套列表1
 + 嵌套列表1a
 + 嵌套列表1b
  - 嵌套列表1ai
   * 嵌套列表1aix
- 嵌套列表2
  • 嵌套列表1
  • 嵌套列表1a
  • 嵌套列表1b
    • 嵌套列表1ai
      • 嵌套列表1aix
  • 嵌套列表2

5.分割线

三个或更多-_*,必须单独一行,可含空格(注意如果在文字后使用---,则为副标题)

---
___
***

效果:


6.链接与图片

在 Markdown 中,插入链接不需要其他按钮,你只需要使用[显示文本](链接地址) 这样的语法即可,例如:

文字超链:[简书](http://www.jianshu.com)
索引超链:
[百度][1]
[1]:http://www.baidu.com

自动链接:http://www.google.com   
邮箱链接:<northpolecan@xx.com>

简书
[百度][1]
[1]:http://www.baidu.com
http://www.google.com
northpolecan@xx.com

图片超链:在 Markdown 中,插入图片不需要其他按钮,你只需要使用 [图片上传失败...(image-45d29e-1570942014833)] 这样的语法即可,例如:

![](http://upload-images.jianshu.io/upload_images/259-0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

*注:插入图片的语法和链接的语法很像,只是前面多了一个 !。*

7. 添加代码

Markdown语法:

`字符`(简短文字添加代码框)
`Tab`或四个空格(大段文字添加代码框,每行前添加)

字符
Tab或四个空格
大段代码框:在你的代码块的前面和后面都加上三个反引号 ` 即可,在第一行后指定编程语言,也可以不指定

@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None
class SomeClass:
    pass
>>> message = '''interpreter
... prompt'''

8.转义字符

特殊符号前可以加反斜线表示转义

\\ 反斜杠

\` 反引号

\* 星号

\_ 下划线

\{\} 大括号

\[\] 中括号

\(\) 小括号

\# 井号

\+ 加号

\- 减号

\. 英文句号

\! 感叹号

\ 反斜杠
` 反引号
* 星号
_ 下划线
{} 大括号
[] 中括号
() 小括号
# 井号
+ 加号
- 减号
. 英文句号
! 感叹号
9.表格
=====
1.使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行:

name | age   区分单元格
---- | ---         分隔表头和其他行
LearnShare | 12
Mike | 32
name age
LearnShare 12
Mike 32
2.为了美观,可以使用空格对齐不同行的单元格,并在左右两侧都使用 来标记单元格边界:
| name | age |
| ---------- | --- |
| LearnShare | 12 |
| Mike | 32 |
name age
LearnShare 12
Mike 32

在表头下方的分隔线标记中加入 :,即可标记下方单元格内容的对齐方式:

| left | center | right |
| :--- | :----: | ----: |
| aaaa | bbbbbb | ccccc |
| a | b | c |
left center right
aaaa bbbbbb ccccc
a b c

10.其他

段落缩进

半方大的空白 或 看,飞碟
全方大的空白 或 看,飞碟
不断行的空白格 或 看,飞碟
  段落从此开始。

HTML标签

<small>小字</small>
<br>强制换行
<big>大字</big>

<small>小字</small>


<big>大字</big>

推荐阅读更多精彩内容