实用Markdown实践指南

手把手教你用Markdown轻量标记语言写文章

Posted by LZP[原创] on August 2, 2018

目录

目录可以用[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. 返回一级列表。
  1. 数字和点开始有序列表。

    1. 注意子列表的缩进位置。

      1. 三级列表。
      2. 编号会自动更正。
    2. 二级列表,编号自动更正为2。

  2. 返回一级列表。

列表续行、段落和代码块

1. 列表项可以折行,
  对齐则自动续行。

2. 列表项可包含多个段落。

    空行开始的新段落必须缩进四个空格,
    段落才属于列表项。

3. 列表中的代码块要缩进8个空格。

        $ printf "Hello, world.\n"
  1. 列表项可以折行, 对齐则自动续行。

  2. 列表项可包含多个段落。

    空行开始的新段落必须缩进四个空格, 段落才属于列表项。

  3. 列表中的代码块要缩进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

内部跳转

<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

GitHub Logo: GitHub


表格(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>
HTML块中不能混用 **标记语法**

其它说明

  • Markdown是在Ruby应用中广泛使用的标记语言,语法简洁并可混用HTML。 标准的Markdown语法缺乏如表格等关键特性的支持, 虽然不同的解析器都对其语法进行了扩展,但实现各有不同,造成一定的混乱。 网址:http://daringfireball.net/projects/markdown/。

  • GitHub使用Redcarpet作为Markdown的解析工具,并添加了额外的语法扩展。 网址:http://github.github.com/github-flavored-markdown/。


本文档用Markdown写成!