Markdown语法 简单介绍


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

这是一个标题。

  1. 这是第一行列表项。
  2. 这是第二行列表项。

给出一些例子代码:

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. 但仍然推荐按照自然顺序(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>

Alt text

Alt text

Alt text

http://example.com/

address@example.com

Markdown 不支持指定图片的显示大小,不过可以通过直接插入标签来指定相关属性

12. 字符转义

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\   反斜线
`   反引号
*   星号
_   底线
&#123;&#125;  花括号
[]  方括号
()  括弧
\#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

\ 反斜线

` 反引号

* 星号

_ 底线

{} 花括号

[] 方括号

() 括弧

# 井字号

+ 加号

- 减号

. 英文句点

! 惊叹号

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 中的行内标记


参考文档


Author: Itaken
Reprint policy: All articles in this blog are used except for special statements CC BY 4.0 reprint polocy. If reproduced, please indicate source Itaken !
  TOC目录