目录
目录可以用[toc],直接生成;(需要使用标题格式,以便于索引)
标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题 ######
段落
空行分段
第一段内容。
第二段和第一段间有一空行。
第一段内容。
第二段和第一段间有一空行。
自动续行
一个回车不分段,
本行续上行。(GFM保持段落内换行符)
一个回车不分段, 本行续上行。(GFM保持段落内换行符)
插入换行
行尾两空格 保持换行。
行尾两空格 保持换行。
段落缩进
邮件体段落缩进:
> 第一级段落缩进。
>
> > 第二级段落缩进。
>
> 返回一级段落缩进。
邮件体段落缩进:
第一级段落缩进。
第二级段落缩进。
返回一级段落缩进。
代码块
代码块(标准)
四个空格缩进是代码块
def foo():
print "Love Python, Love FreeDome"
print "E文标点,.0123456789,中文标点,. "
说明:本文显示的所有Markdown代码均是通过四个空格缩进实现
代码块(gfm扩展)
【gfm】三个连续的`或~等符号界定代码块。
```ruby
require 'redcarpet'
md = Redcarpet.new("Hello, world.")
puts md.to_html
```
require 'redcarpet'
md = Redcarpet.new("Hello, world.")
puts md.to_html
~~~ruby
require 'redcarpet'
md = Redcarpet.new("Hello, world.")
puts md.to_html
~~~
require 'redcarpet'
md = Redcarpet.new("Hello, world.")
puts md.to_html
列表
无序列表
* 星号、减号、加号开始列表。
- 列表层级和缩进有关。
+ 和具体符号无关。
* 返回一级列表。
-
星号、减号、加号开始列表。
-
列表层级和缩进有关。
- 和具体符号无关。
-
-
返回一级列表。
有序列表
1. 数字和点开始有序列表。
1. 注意子列表的缩进位置。
1. 三级列表。
1. 编号会自动更正。
1. 二级列表,编号自动更正为2。
1. 返回一级列表。
-
数字和点开始有序列表。
-
注意子列表的缩进位置。
- 三级列表。
- 编号会自动更正。
-
二级列表,编号自动更正为2。
-
-
返回一级列表。
列表续行、段落和代码块
1. 列表项可以折行,
对齐则自动续行。
2. 列表项可包含多个段落。
空行开始的新段落必须缩进四个空格,
段落才属于列表项。
3. 列表中的代码块要缩进8个空格。
$ printf "Hello, world.\n"
-
列表项可以折行, 对齐则自动续行。
-
列表项可包含多个段落。
空行开始的新段落必须缩进四个空格, 段落才属于列表项。
-
列表中的代码块要缩进8个空格。
$ printf "Hello, world.\n"
定义(无)
分隔线
三条或更多短线(或星号、下划线)\显示为分隔线。
---
***
___
字体
粗体和斜体
这些都是 **粗体** 或 __粗体__ ,
这些都是 *斜体* 或 _斜体_ 。
这些都是 粗体 或 粗体 , 这些都是 斜体 或 斜体 。
删除线
~~删除线~~ 效果
删除线 效果
下划线
<u>下划线</u> 效果
下划线 效果
上标、下标
Water: H<sub>2</sub>O
E = mc<sup>2</sup>
注解:通过直接嵌入HTML代码实现。
Water: H2O E = mc2 注解:通过直接嵌入HTML代码实现。
等宽字体
行内反引号嵌入代码,如: `git status` 。
行内反引号嵌入代码,如: git status
。
引言(无)
清除标记空白(无)
链接
URL自动链接(gfm)
网址 http://github.com/
邮件 me@foo.bar
网址 http://github.com/ 邮件 me@foo.bar
文字链接
- 访问 [Google](http://google.com "Search")
- 访问 [GitHub][1]
- 访问 [WorldHello][]
[1]: http://github.com "Git host"
[worldhello]: http://www.worldhello.ne
- 访问 Google
- 访问 GitHub
- 访问 WorldHello
内部跳转
<a name="md-anchor" id="md-anchor"></a>
跳转至 [文内链接](#md-anchor) 。
跳转至 [删除线](#删除线) 。
跳转至 文内链接 。
跳转至 删除线 。
脚注(扩展实现)
[^孔子]: 子指孔子,中国古代最有影响力的思想家、教育家!
子[^孔子]曰:学而时学习之,不亦乐乎!
子[^孔子]曰:学而时学习之,不亦乐乎!
图片
![GitHub](https://longzeping.github.io/img/apple-touch-icon.png "Logo")
GitHub Logo: ![GitHub][logo]
[logo]: https://longzeping.github.io/img/apple-touch-icon.png "Logo"
GitHub Logo:
表格(gfm扩展实现)
head1 | head2 | head2
------|:------:|------:
left | center | right
left | center | right
head1 | head2 | head2 |
---|---|---|
left | center | right |
left | center | right |
|姓名|性别|年龄|分数|
|:---:|:---:|---:|---:|
|张三|男|8|60|
|李四|女|20|
|王五|男| |90|
姓名 | 性别 | 年龄 | 分数 |
---|---|---|---|
张三 | 男 | 8 | 60 |
李四 | 女 | 20 | |
王五 | 男 | 90 |
其它
混用HTML
<div style="background:#bbb;">
HTML块中不能混用 **标记语法**
</div>
其它说明
-
Markdown是在Ruby应用中广泛使用的标记语言,语法简洁并可混用HTML。 标准的Markdown语法缺乏如表格等关键特性的支持, 虽然不同的解析器都对其语法进行了扩展,但实现各有不同,造成一定的混乱。 网址:http://daringfireball.net/projects/markdown/。
-
GitHub使用Redcarpet作为Markdown的解析工具,并添加了额外的语法扩展。 网址:http://github.github.com/github-flavored-markdown/。