如有纰漏，敬请指出！谢谢~

Markdown的宗旨

目标是实现「易读易写」。一份使用 Markdown 格式撰写的文件应该是可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。Markdown 语法受到一些既有 text-to-HTML 格式的影响，其中包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText。
Markdown语法全由一些符号所组成，这些符号经过精挑细选，其作用一目了然。
Markdown 并不是想要取代 HTML，甚至也没有要和它相近，它的语法种类很少，只对应 HTML 标记的一小部分。

其理念是，能让文档更容易读、写和随意改。HTML 是一种发布的格式，Markdown 是一种书写的格式。

Markdown语法：参考网站

常用的插入 比较

• • 插入图片
    输入格式：名字+图片URL

    效果：

    小猫喵
    
    
    

• • 插入文字链接
    输入格式：名字+响应请求的URL

    效果：
    小猫喵: 点我，我就出来 ~
    
    

• • 插入图片➕文字链接
    输入格式：名字+响应请求的URL+图片的URL

    
    

    效果：
    图片加链接：

    [图片上传失败...(image-492b0b-1512543899471)]](http://upload-images.jianshu.io/upload_images/1870963-b570b8d26138b8d1.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/800)

输入格式 及 效果

1.文档中插入一个版权符号 ©

输入格式：

效果：©

2.标题

两种标题的语法，类 Setext 和类 atx 形式。

• • 【一】、类 Setext 形式是用底线的形式
    输入格式：

    效果：

    This is an H1

    This is an H2

• • 【二】、类 Atx 形式
• • • 在行首插入 1 到 6 个 “#” ，对应到标题 1 到 6 阶
      输入格式：
    
    

    效果：(阶数 决定 大小)

    这是H1

    这是H2

    这是H3

• • • 选择性地「闭合」类 atx 样式的标题，这纯粹只是美观用的。（⭐️行首的井字符⭐️数量决定标题的阶数）
      输入格式：
    
    

    效果：

    这是H1

    这是H2

    这是H3

3.区块引用 Blockquotes

输入格式：

效果：

This is a blockquote with two paragraphs. 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.

也允许你⭐️偷懒只在整个段落的⭐️第一行最前面⭐️加上 “>”。
输入格式：

This is a blockquote with two paragraphs. 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.

• • 区块引用可以嵌套
    输入格式：

    效果：

    This is the first level of quoting.

    This is nested blockquote.

    Back to the first level.

• • 引用的区块内也可以使用其他的 Markdown 语法
    包括：标题、列表、代码区块等……
    输入格式：

    效果：

    这是一个标题。

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

    给出一些例子代码：

    return shell_exec("echo $input | $markdown_script");
    

4.列表

• 【一】、无序列表
  使用星号、加号或是减号作为列表标记

  输入格式：（三种）

  效果：

  • Red
  • Green
  • Blue

• 【二】、有序列表
  则使用数字接着一个英文句点

  1. Bird
  2. McHale
  3. Parish

  很重要的一点是，你在列表标记上使用的数字并不会影响输出的 HTML 结果，上面的列表所产生的 HTML 标记为：

  
  

  你都会得到完全相同的 HTML 输出。

  ⭐️：重点在于，你可以让 Markdown 文件的列表数字和输出的结果相同，或是你懒一点，你可以完全不用在意数字的正确性。
  
  
  

特别演示

输入格式：

效果：
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>

• • 列表项目标记通常是放在最左边，但是其实也可以⭐️缩进，最多 3 个空格，项目标记后面则一定要接着至少一个空格或制表符。

    输入格式：

    
    

    效果：

    • 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
      inside a list item.

• • 要放入代码区块的话

    该区块就需要缩进两次，也就是 8 个空格或是 2 个制表符
    
    输入格式：

    效果：

    • 一列表项包含一个列表区块：

      <代码写在这>
      

• • 项目列表很可能会不小心产生，像是下面这样的写法：

    产生的效果：

    1986. What a great season.

    
    
    换句话说，也就是在行首出现数字-句点-空白。

    
    要避免这样的状况，你可以在句点前面加上反斜杠。

    改善后，新产生的效果：
    1986. What a great season.

5.代码区块

要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格⭐️或是 1 个制表符⭐️就可以了。

输入格式：

效果：

这是一个普通段落：

这是一个代码区块。

在代码区块里面， “&” 、 “<” 和 “>” 会自动转成 ⭐️HTML 实体，这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码，只需要复制贴上，再加上缩进就可以了，剩下的 Markdown 都会帮你处理，例如：

输入：

我们看到的效果：

<div class="footer">
© 2004 Foo Corporation
</div>

6.删除线

两个波浪线开头，两个波浪线结尾 放在中间的部分就被加上删除线了!
譬如:此🌰，哈哈

输入格式：

效果：
I Love You! It's Wrong!</br>
I Hate You!
It's True
Do you trust?

7.分隔线

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。
也可以在星号或是减号中间插入空格。

输入格式：

效果：

---

ads

---

goyohol

---

qp

---

sdfd（产生的字体 大一些）

8.区段元素

• 链接
  
  给个🌰：

  得到的效果
  文字链接：小猫喵: 点我吧！点我就让你看哦 ~
  
  
  

详细内容参考：Markdown语法说明(简体中文)

9.强调

粗体和斜体

输入格式：

会转为:

效果：
single asterisks

single underscores

double asterisks

double underscores

• ⭐️

  效果:
  unfriggingbelievable
  
  

  ---

  效果:
  *this text is surrounded by literal asterisks*

10.代码

阴影效果： 两个 “`”符号中间的内容注上阴影！

“`”符号输出方式： (英文输入模式)

保证在英文输入模式

输入"`" 的方式

操作键示意

效果：
Use the printf() function.

效果：
There is a literal backtick (`) here.

效果：
A single backtick in a code span: `
A backtick-delimited string in a code span: `foo`

效果：
— is the decimal-encoded equivalent of —.

(※※※※※ 同样可以作用于 图片的注释 ※※※※※)
输入格式：

`APPDelegate.h`.png

效果：
AppDelegate.h

11.图片

• 【一】、行内式

  详细叙述如下：
  一个惊叹号 !
  接着一个方括号，里面放上图片的替代文字
  接着一个普通括号，里面放上图片的网址(⭐️URL:统一资源定位符)，最后还可以用引号包住并加上 选择性的 'title' 文字。
  
  

• 【二】、参考式

举个🌰： 行内式
输入格式：

效果：

小猫喵

12.自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用尖括号包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样。

效果：
goyohol个人主页：http://www.jianshu.com/users/0c0805f8de58/latest_articles

13.反斜杠

可以利用反斜杠来插入一些在语法中有其它意义的符号。
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

14.表格

输入格式：

效果：

输入格式：

输入格式：

15.显示链接中带括号的图片

有些使用到HTML的地方，可能已经改变了！！所以请直接跳过无效的部分！！

但是至今不能使用！！有点烦~~~

换行

最烦的是不能使用“</br>”换行！

不过聪明如我！自有妙计！

使用：

效果：

abc

efg

goyohol's essay