markdown简介及操作

---

一 概念

在Web端，无论是写博文、提交项目代码、格式化文本文件，Markdown都是一种值得掌握的编辑语言。

Markdown 是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。 Github以Markdown作为默认文档格式,且大多博客系统都支持Markdown格式。

二 特点

语法简洁明了、“更少鼠标操作”，容易掌握
功能强大，可以导入多种文件类型（HTML、PDF）
本身的纯文本内容，兼容所有文本编辑器

三 语法

Markdown 的常用语法均由一些符号所组成，总共就十来种，一目了然。这里展示的部分语法是标准markbook的扩展版本中的，如Ghost Blog、Pandoc等。

1. 调标题

标题分为1-6级，调整方式有两种：

1. 标准方式：[#][空格][标题]，“#”数量代表标题级别；
   
   
2. 简要方式：在文字下方添加“=”（一级标题）和“-”（二级标题）。标题只能分为两级，和符号多少无关。

2. 调字体

通过以下方式可以改变正文的字体大小。

格式：<font> size = 4 "正文一般采用4号字体正好" </font>`

3. 引用块

引用块（blockquote）是最常见的语法，期内可以嵌套使用其他makedown语法。

1. 通过在文字开头添加“>”表示块注释。（当“>”和“文字”之间的空格数量>=5时，块结构会发生变化，相当于插入代码块，相应字体会变小）
2. 区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 “>”

4. 代码片

实现方式有两种：

1. 少量内容：连续两行分别敲出三个英文格式的` ，不是单引号而是键盘左上角的ESC下面~中的` ；
2. 大量内容：在段落开头敲：Tab+四个空格。

5. 插列表

Markdown 支持有序列表和无序列表。列表项目标记通常是放在最左边，但是其实也可以缩进，最多 3 个空格，项目标记后面则一定要接着至少一个空格或制表符。在列表标记上使用的数字并不会影响输出的 HTML 结果。

1. 无序列表：使用”“、”+”或者”-“作为列表标记，如 here，+ here，- here；
2. 有序列表：使用数字接着一个英文句点，如1. here。

6. 插链接

Markdown 支持两种形式的链接语法： 行内式和参考式两种形式。链接文字都用 “[ ]”来标记。

1. 行内式： 在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：

   This is [an example](http://blog.csdn.net/yu123zi123lin123/article/details/73502058 "Title") inline link.[This link](http://blog.csdn.net/yu123zi123lin123/article/details/73502058) has no title attribute.

   结果：
   This is an example inline link.
   This link has no title attribute.

2. 参考式：在链接文字的括号后面再接上另一个方括号，而再在第二个方括号里面填入用以辨识链接的标记即可，例如：

   This is [an example][id] reference-style link.

   结果：
   This is [an example][id] reference-style link.
   接着，在文件的任意处，你可以把这个标记的链接内容定义出来：

   [id]: http://example.com/  "Title"

7. 插图片

图片的处理方式和链接的处理方式，非常的类似。格式：一个惊叹号 “!”，接着一个方括号”[]”里面为图片代替文字，接着一个普通括号”()”，里面存放图片网址，最后还可以用引号包住并加上 选择性的 ‘title’ 文字。

1. 行内式：

   ![Alt text](/path/to/img.jpg)![Alt text](/path/to/img.jpg "Optional title")

   结果：
   
   

2. 参考式：

   ![Alt text][id]id是图片参考的名称，图片参考的定义方式则和链接参考一样：[id]: url/to/image  "Optional title attribute"

   结果：
   ![Alt text][id]
   [id]: url/to/image “Optional title attribute”

8. 分隔线

分割线（一条横线）的建立方式多种多样，主要为以下几种：

* * *********----------，前后需空一行

结果：

---

9. 斜体字

将需要设置为斜体的文字两端使用1个“*”或者“_”夹起来

*123*，_123_

结果：
123，123

10. 粗体字

将需要设置为斜体的文字两端使用2个“*”或者“_”夹起来

**123**，__123__

结果：
123，123

11. 反斜杠

利用反斜杠”\”可以实现插入一些在语法中有其它意义的符号，是之以普通字符显示。

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

\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧

12. 脚注

与word文档一样，脚注（footnote）会出现在页面最下方,脚注在代码块里也以结果展示，故使用中文【】。

实现方式如下：

hello【^hello1】hello【^hello2】脚注含义【结果序号只与脚注在文中的顺序有关，与这里的title无关】：【^hello1】 hi【^hello2】 hi

结果：
hello1
hello[^hello2]

13. 删除线

表示某一文段文字被删除，格式:使用~~ 内容 ~~，“内容”前后实际上无空格，有空格就不能删除。

~~See you again!?~~

结果：
See you again!?

14. 画横线

横线只能跟在文字内容中间，否则容易被当做二级标题处理，


画水平线 (HR) :---------------：---------------
==text==
结果：
画水平线 (HR) :—————：—————

15. 插代码

有时需要在内容中插入简单代码，无需代码块也可以完成：

内嵌代码 : `alert('Hello World');`

结果：
内嵌代码 : `alert(‘Hello World’);

---

6,7,12的参考式结果均未正常显示，难道是版本问题么，求留言解答

---

四、扩展部分

欢迎使用Markdown编辑器写博客

本Markdown编辑器使用[StackEdit][6]修改而来，用它写博客，将会带来全新的体验哦：- **Markdown和扩展Markdown简洁的语法**- **代码块高亮**- **图片链接和图片上传**- ***LaTex*数学公式**- **UML序列图和流程图**- **离线写博客**- **导入导出Markdown文件**- **丰富的快捷键**-------------------## 快捷键 - 加粗    `Ctrl + B`  - 斜体    `Ctrl + I`  - 引用    `Ctrl + Q` - 插入链接    `Ctrl + L` - 插入代码    `Ctrl + K` - 插入图片    `Ctrl + G` - 提升标题    `Ctrl + H` - 有序列表    `Ctrl + O` - 无序列表    `Ctrl + U` - 横线    `Ctrl + R` - 撤销    `Ctrl + Z` - 重做    `Ctrl + Y`## Markdown及扩展> Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成格式丰富的HTML页面。    —— <a href="https://zh.wikipedia.org/wiki/Markdown" target="_blank"> [ 维基百科 ]使用简单的符号标识不同的标题，将某些文字标记为**粗体**或者*斜体*，创建一个[链接](http://www.csdn.net)等，详细语法参考帮助？。本编辑器支持 **Markdown Extra** , 　扩展了很多好用的功能。具体请参考[Github][2].  ### 表格**Markdown　Extra**　表格语法：项目     | 价格-------- | ---Computer | $1600Phone    | $12Pipe     | $1可以使用冒号来定义对齐方式：| 项目      |    价格 | 数量  || :-------- | --------:| :--: || Computer  | 1600 元 |  5   || Phone     |   12 元 |  12  || Pipe      |    1 元 | 234  |###定义列表**Markdown　Extra**　定义列表语法：项目１项目２:   定义 A:   定义 B项目３:   定义 C:   定义 D    > 定义D内容### 代码块代码块语法遵循标准markdown代码，例如：``` python@requires_authorizationdef somefunc(param1='', param2=0):    '''A docstring'''    if param1 > param2: # interesting        print 'Greater'    return (param2 - param1 + 1) or Noneclass SomeClass:    pass>>> message = '''interpreter... prompt'''<div class="se-preview-section-delimiter"></div>

脚注

生成一个脚注2.

目录

用 [TOC]来生成目录：

数学公式

使用MathJax渲染LaTex 数学公式，详见math.stackexchange.com.

• 行内公式，数学公式为：Γ(n)=(n−1)!∀n∈N。
• 块级公式：

x=−b±b2−4ac−−−−−−−√2a

更多LaTex语法请参考 这儿.

UML 图:

可以渲染序列图：

张三->李四: 嘿，小四儿, 写博客了没?Note right of 李四: 李四愣了一下，说：李四-->张三: 忙得吐血，哪有时间写。<div class="se-preview-section-delimiter"></div>

或者流程图：

• 关于 序列图 语法，参考 这儿,
• 关于 流程图 语法，参考 这儿.

离线写博客

即使用户在没有网络的情况下，也可以通过本编辑器离线写博客（直接在曾经使用过的浏览器中输入write.blog.csdn.net/mdeditor即可。Markdown编辑器使用浏览器离线存储将内容保存在本地。

用户写博客的过程中，内容实时保存在浏览器缓存中，在用户关闭浏览器或者其它异常情况下，内容不会丢失。用户再次打开浏览器时，会显示上次用户正在编辑的没有发表的内容。

博客发表后，本地缓存将被删除。　

用户可以选择 把正在写的博客保存到服务器草稿箱，即使换浏览器或者清除缓存，内容也不会丢失。

注意：虽然浏览器存储大部分时候都比较可靠，但为了您的数据安全，在联网后，请务必及时发表或者保存到服务器草稿箱。

或者流程图：```flowst=>start: 开始e=>end: 结束op=>operation: 我的操作cond=>condition: 确认？st->op->condcond(yes)->econd(no)->op<div class="se-preview-section-delimiter"></div>

• 关于 序列图 语法，参考 这儿,
• 关于 流程图 语法，参考 这儿.

离线写博客

即使用户在没有网络的情况下，也可以通过本编辑器离线写博客（直接在曾经使用过的浏览器中输入write.blog.csdn.net/mdeditor即可。Markdown编辑器使用浏览器离线存储将内容保存在本地。

用户写博客的过程中，内容实时保存在浏览器缓存中，在用户关闭浏览器或者其它异常情况下，内容不会丢失。用户再次打开浏览器时，会显示上次用户正在编辑的没有发表的内容。

博客发表后，本地缓存将被删除。　

用户可以选择 把正在写的博客保存到服务器草稿箱，即使换浏览器或者清除缓存，内容也不会丢失。

注意：虽然浏览器存储大部分时候都比较可靠，但为了您的数据安全，在联网后，请务必及时发表或者保存到服务器草稿箱。

浏览器兼容

1. 目前，本编辑器对Chrome浏览器支持最为完整。建议大家使用较新版本的Chrome。
2. IE９以下不支持
3. IE９，１０，１１存在以下问题
   
   1. 不支持离线功能
   2. IE9不支持文件导入导出
   3. IE10不支持拖拽文件导入

---

“`

---

1. hi;
   [^hello2]: hii ↩
2. 这里是 脚注 的 内容. ↩