以下语法是在在MarkdownPad 2中选择 GitHub 风格 Markdown处理器
进行编辑,不同处理器语法可能会有小差别
标题
如下形式:
# 一级标题内容
## 二级标题内容
### 三级标题内容
#### 四级标题内容
##### 五级标题内容
###### 六级标题内容
- 通过使用1到6个#符号加上标题内容生成标题,1到6个#符号分别对应一到六级标题,一级标题最大
- 正确使用标题可建立清晰的文章导航和文章脉络
- 二级标题会在下面自动添加一道较细的横线,如上述小标题就是二级标题
- 建议在#号后加一个空格,这是最标准的 Markdown 语法
- 等号及减号也可以进行标题的书写,不过只能书写二级标题,并且需要写在文字的下面,减号及等号的数量不会影响标题的基数
如下形式:
另一种二级标题内容表示
=========
另一种二级标题内容表示
---------
*注:建议还是使用#
的方法
列表
无序列表
如下形式:
- 无序列表1内容
- 无序列表2内容
- 无序列表3内容
- 通过在符号“
-
”后加空格再加上内容进行生成,注意一定要在符号“-
”后加一个空格,无序列表则在无序列表内容前面加一个小点,如本句则是一个无序列表的一条 - 按一次回车会自动添加一条列表内容,也即自动生成“
-
”符号,继续进行列表内容编辑,直到出现一行空行才退出这条列表内容编辑,也即按两次才退出列表内容编辑
有序列表
如下形式:
1. 有序列表1内容
2. 有序列表2内容
3. 有序列表3内容
通过在数字及符号“.
”后加空格再加上内容进行生成,注意一定还需加上空格进行分割,则会生成带1. 2. 3.
的有序列表项
列表层级套嵌
如下形式:
- 无序列表1
- 无序列表2
- 无序列表2.1
- 列表内容
- 列表内容
- 无序列表3
通过在符号“-
”前添加空格,则可控制有序、无序列表的层级,根据距左边空格数控制层级,空格数相同的属一个层级,也即在一列,前面会有相同层级标识图案。
引用
如下形式:
> 引用内容
> 接着上方引用内容
通过在符号“>
”(大于号)后加上空格再加上所需引用内容进行生成,注意一定要加上空格,也直到出现一行空号退出引用内容编辑.
粗体与斜体
如下形式:
*需斜体显示内容*
**需粗体显示内容**
***需粗体加斜体显示内容***
粗体的使用是在需要加粗的文字前后各加两个“*
”,斜体的使用则是在需要斜体的文字前后各加一个“*
”,如果要使用粗体和斜体,那么就是在需要操作的文字前后各加三个“*
”
链接与图片
如下形式:
[链接文字](链接地址)
![图片描述](图片地址)
插入链接与插入图片的语法很像,区别在一个!
号。
代码块
一段代码(用反引号)
如下形式:
“`代码类型
一大段代码
“`
通过使用3个“`”反引号括起所需展示的大段代码,以及在第一行反引号后面加上所展示代码类型名,如php、js等
一段代码(用Tab键)
如下形式:
`Tab`一行代码
`Tab`又一行代码
`Tab`又来一行代码
`空格``空格``空格``空格`这也能表示一行代码
- 用TAB键起始的段落,会被认为是代码块,也即4个空格起始的段落,1个Tab = 4个空格
- 只能保证一行代码的显示,每行代码前面都需要添加
一行代码
如下形式:
`想显示的一行代码`
通过使用1个“`”反引号的包裹在句子中显示一行代码。
表格
如下形式:
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
通过使用“|”符号分割表格的每格,以及“-”减号及“:”冒号表示对齐方式,减号的个数不限,但减号至少要有一个
- 若没有冒号或冒号在减号左边表示左对齐
- 减号两边都有表示中间对齐
- 若在减号右边表示右对齐
第一行表格每类的名字一定要有以及减号和冒号的一行也一定要有,第一行属性会自动黑体加粗,即第一行是表格属性名,第二行则是表格对齐方式,第三行是表格输出的第一行内容,第四行是第二行内容,以此类推
- 注意上述的冒号一定要是英文模式下输入,不可在中文形式,一定要注意
分割线与删除线
分割线
如下形式:
---
****
___
- 可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,同时需要在分隔线的上面空一行。
删除线
如下形式:
~~Mistaken text.~~
删除线的使用,在需要删除的文字前后各使用两个符号“~
”。
反斜杠
可添加如下符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
Markdown 可以利用反斜杠“\”来插入一些在语法中有其它意义的符号。