Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
Markdown 编写的文档可以导出 HTML、Word、PDF 等其他格式的文档。
Markdown 编写的文档后缀为.md
,.markdown
。
1. Setext 形式
This is an H1
=============
This is an H2
-------------
This is an H1
This is an H2
= 和 - 的数量是没有限制的。通常的做法是使其和标题文本的长度相同
2. atx 形式
# 这是 H1
## 这是 H2
###### 这是 H6
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######
这是 H1
这是 H2
这是 H6
这是 H1
这是 H2
这是 H3
可以用对称的 #, 也可以只在左边使用 #
3. 引用
> 区块引用 Blockquotes
>
> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
>> 给出一些例子代码:
>
> return shell_exec("echo $input \| $markdown_script");
区块引用 Blockquotes
这是一个标题。
- 这是第一行列表项。
- 这是第二行列表项。
给出一些例子代码:
return shell_exec(“echo $input | $markdown_script”);
4. 列表
* Green
+ Red
- Blue
列表项目可以包含多个段落,每个项目下的段落都必须``缩进`` 4 个空格或是 1 个制表符:
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
* A list item with a blockquote:
> This is a blockquote
1986\. What a great season.
- Green
- Red
- Blue
列表项目可以包含多个段落,每个项目下的段落都必须缩进
4个空格或是 1个制表符:
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.A list item with a blockquote:
This is a blockquote
1986. What a great season.
1. 有序列表以数字和 `.` 开始;
3. 数字的序列并不会影响生成的列表序列;
4. 但仍然推荐按照自然顺序(1.2.3...)编写。
- 有序列表以数字和
.
开始 - 数字的序列并不会影响生成的列表序列
- 但仍然推荐按照自然顺序(1.2.3…)编写
5. 代码块
要在 Markdown 中建立代码区块很简单,只要简单地缩进 4个空格或是 1个制表符就可以.
要在 Markdown 中建立代码区块很简单,只要简单地缩进 4个空格或是 1个制表符就可以.
6. 代码块, 行内代码块
Use the `printf()` function.
``There is a literal backtick (`) here.``
\```
abc
\```
<pre>
def
</pre>
Use the printf()
function.
There is a literal backtick (`) here.
abc
def
7. 行内代码块
A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``
Please don't use any `<blink>` tags.
A single backtick in a code span: `
A backtick-delimited string in a code span: `foo`
Please don’t use any <blink>
tags.
8. 文字强调
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
single asterisks
single underscores
double asterisks
double underscores
使用 * * 或 _ _ 包括的文本会被转换为 ,通常表现为斜体;
使用 ** ** 或 __ __ 包括的文本会被转换为 ,通常表现为加粗;
*、**、_ 和 __ 都必须 成对使用.
~~删除线~~
删除线
9. 分隔线
* * *
***
*****
- - -
---------------------------------------
可以在一行中使用三个或更多的 *、- 或 _ 来添加分隔线, 字符之间可以有空格
10. 超链接
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
See my [About](/about/) page for details.
This is [an example][id] reference-style link.
[id]: http://example.com/ "Optional Title Here"
I get 10 times more traffic from [Google][] than from [Yahoo][] or [MSN][].
[google]: http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"
This is an example inline link.
This link has no title attribute.
See my About page for details.
This is an example reference-style link.
I get 10 times more traffic from Google than from Yahoo or MSN.
11. 图片
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
![Alt text][id]
[id]: /path/to/img.jpg
<http://example.com/>
<address@example.com>
Markdown 不支持指定图片的显示大小,不过可以通过直接插入标签来指定相关属性
12. 字符转义
Markdown 支持以下这些符号前面加上反斜杠
来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
\# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
13. 表格
name | gender
---- | ---
itaken | male
itaken | female
|name | gender |
|---- | --- |
|itaken | male |
|itaken | female |
| left | center | right |
| :--- | :----: | ----: |
| aaaa | bbbbbb | ccccc |
| a | b | c |
name | gender |
---|---|
itaken | male |
itaken | female |
name | gender |
---|---|
itaken | male |
itaken | female |
left | center | right |
---|---|---|
aaaa | bbbbbb | ccccc |
a | b | c |
表格中可以插入其他 Markdown 中的行内标记