为什么使用 Markdown

目录

[TOC]

如何使用 Markdonw

1. 标题级别

效果

这是 H1 一级标题

这是 H2 二级标题 ——

这是 H1 一级标题

这是 H2 二级标题

这是 H3 三级标题

这是 H4 四级标题

这是 H5 五级标题
这是 H6 六级标题

代码

这是 H1 一级标题
======
这是 H2 二级标题
------
# 这是 H1 一级标题
## 这是 H2 二级标题
### 这是 H3 三级标题
#### 这是 H4 四级标题
##### 这是 H5 五级标题
###### 这是 H6 六级标题

2. 列表

效果

代码 (注意星号与文字之间的空格)

* 列表1
* 列表2
* 列表3

效果

  1. 有序列表1
  2. 有序列表2
  3. 有序列表3

代码 (注意点号与文字之间的空格)

1. 有序列表1
2. 有序列表2
3. 有序列表3

3. 引用

行内代码引用

效果

来试试 Markdown

代码

来试试 `Markdown` 吧

代码块引用

效果

def hello():
    print 'hello, world'

代码

```python
def hello():
    print 'hello, world'
```

文字引用

效果

春 眠 不 觉 晓, 处 处 闻 啼 鸟。
夜 来 风 雨 声, 花 落 知 多 少。

代码(需要换行可在句末加两个空格)

> 春 眠 不 觉 晓,
> 处 处 闻 啼 鸟。  
> 夜 来 风 雨 声,
> 花 落 知 多 少。

效果

春 眠 不 觉 晓, 处 处 闻 啼 鸟。
夜 来 风 雨 声, 花 落 知 多 少。

代码(需要换行可在句末加两个空格)

> 春 眠 不 觉 晓,
处 处 闻 啼 鸟。  
夜 来 风 雨 声,
花 落 知 多 少。

效果

春 眠 不 觉 晓,
处 处 闻 啼 鸟。
夜 来 风 雨 声,
花 落 知 多 少。

代码 (行首四个空格, 末尾无需空格)

    春 眠 不 觉 晓,
    处 处 闻 啼 鸟。
    夜 来 风 雨 声,
    花 落 知 多 少。

4. 文字

斜体

效果

这是一个斜体

代码

这是一个*斜体*

粗体

效果

这是一个粗体

代码

这是一个**粗体**

删除线

效果

这是一个删除线

代码

这是一个~~删除线~~

5. 链接

网页链接

效果

参见Wiki词条Markdown

代码

参见Wiki词条[Markdown](http://zh.wikipedia.org/wiki/Markdown)

效果

链接名称 [链接名称][1] [1] : 链接地址

代码

[链接名称](链接地址)
[链接名称][1]
[1] : 链接地址

图片

效果

Wikipedia_logo

代码

![Wikipedia_logo](http://upload.wikimedia.org/wikipedia/commons/6/63/Wikipedia-logo.png)

6. 公式

效果

代码

$$ \sum^{j-1}\_{k=0}{\widehat{\gamma}\_{kj} z_k} $$

公式可以通过MathJax支持, 右击公式有惊喜。
另外,注意如果 markdown 的render 是 redcarpet, LaTex 中下划线与Markdown中冲突,所以需要做转义处理

如果不想做转义处理,可以尝试更改 markdown 的 render, 我现在用的是 redcarpet,可以改成 kramdown. 如果用的是 jekyll 基于 markdown 搭建博客,可以在 _config.yml 中设置 render,参考 jekyll configuration. 感谢评论中 Wead Hsu 提出这一点。

另外,有的 render 在解释文章时可能会出问题,换一个 render 可能就解决了,可以自己实验一下。

7. 目录

效果

[TOC]

代码

[TOC]

上下都需要换行一行.

其他

特别感谢

感谢Cmd Markdown教我使用Markdown

参考文章

Md2All完整教程请参考:https://www.cnblogs.com/garyyan/p/8329343.html 小书匠语法使用手册_小书匠

版本信息

20131024 完成初稿

20180627 添加toc,以及格式

20180821 添加删除线