Markdown语法详解 一般情况及简书上使用

之前工作那木久，一直没时间写些东西！就把工作中的一些总结都记在本地文档！后来发现了简书感觉蛮不错的！
用了之后，把之前用过的Markdown语法过一遍。把一些大概比较有用的都总结出来了！以供大家参考查看！

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

Markdown的宗旨

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

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

Markdown语法：参考网站

请注意，在 HTML 区块标签间的 Markdown 格式语法将不会被处理。比如，你在 HTML 区块内使用 Markdown 样式的强调会没有效果。

常用的插入 比较

• • 插入图片
    输入格式：名字+图片URL
    
    效果：
    
    
• • 插入文字链接
    输入格式：名字+响应请求的URL
    
    效果：
    文字链接：小猫喵: 点我，我就出来 ~
    
• • 插入图片➕文字链接
    输入格式：名字+响应请求的URL+图片的URL
    
    效果：
    图片加链接：
    ](http://upload-images.jianshu.io/upload_images/1870963-b570b8d26138b8d1.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

输入格式 及 效果

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

输入格式：

效果：©

标题

两种标题的语法，类 Setext 和类 atx 形式。
- - 【一】、类 Setext 形式是用底线的形式
输入格式：

效果：

This is an H1

This is an H2

• • 【二】、类 Atx 形式
• • • 在行首插入 1 到 6 个 “#” ，对应到标题 1 到 6 阶
      输入格式：
      
      效果：(阶数 决定 大小)

这是H1

这是H2

这是H3

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

这是H1

这是H2 ##

这是H3

区块引用 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”);

列表

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

  输入格式：（三种）
  
  效果：

  • Red
  • Green
  • Blue

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

  1. Bird
  2. McHale
  3. Parish

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

  
  

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

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

特别演示

输入格式：

效果：

1. Bird
2. McHale
3. Parish

- - 列表项目标记通常是放在最左边，但是其实也可以⭐️缩进，最多 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.

代码区块

要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格⭐️或是 1 个制表符⭐️就可以了。输入格式：效果：这是一个普通段落：

这是一个代码区块。

在代码区块里面， “&” 、 “

删除线

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

输入格式：


效果：
I Love You! It’s Wrong!
I Hate You!
It's True
Do you trust?

分隔线

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

输入格式：


效果：

---

ads

---

goyohol

---

qp

---

sdfd（产生的字体 大一些）

区段元素

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

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

强调

粗体和斜体

输入格式：

会转为:

效果：
single asterisks

single underscores

double asterisks

double underscores

• ⭐️
  
  效果:
  un*frigging*believable
  
  
  
  效果:
  *this text is surrounded by literal asterisks*

代码

效果：
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`



效果：
Please don’t use any <blink> tags.



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

图片

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

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

效果：

自动链接

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




��又来了：
输入格式：

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

反斜杠

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

表格

输入格式：

效果：

输入格式：

效果：

输入格式：

⭐️对齐效果：所在的列的对齐方式(左对齐、居中、右对齐)

左 中 右 左对齐 居中 右对齐

|:—|:—:|—-:|
|左对齐|居中|右对齐|

显示链接中带括号的图片

效果：

goyohol’s essay