Markdown---易读易写

HTML是一种发布的格式,Markdown是一种书写的格式。Markdown的格式语法只涵盖纯文本的范围。

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。添加HTML区块元素标签,需要在其标签前后加上空行与其他内容区分开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。

这是一个普通段落。

<h1>Hello world!</h1>
<p>Plain text</p>

这是另一个普通段落。

注:以下图片中,图左markdown编码,图中效果,图右html编码。

  1. 斜体和粗体
  2. 分级标题
  3. 超链接
    3.1. 行内式
    3.2. 参考式
    3.3. 自动链接
  4. 锚点
  5. 列表
    5.1. 无序列表
    5.2. 有序列表
    5.3. 定义型列表
    5.4. 列表缩进
    5.5. 包含段落的列表
    5.6. 包含引用的列表
    5.7. 包含代码区块的引用
  6. 引用 6.1. 引用的多层嵌套 6.2. 引用其它要素
  7. 插入图像
    7.1. 行内式
    7.2. 参考式
  8. 表格
  9. 分隔线
  10. 代码
  1. 斜体和粗体
  • 斜体:将需要设置为斜体的文字两端使用1个“*”或者“_”夹起来

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

    斜体或_斜体_
    粗体
    加粗斜体
    删除线

image

  1. 分级标题 {#headline}
    Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。
    2.1.类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),如下:

This is an H1

This is an H2

image

2.2. 类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,如下:

这是 H1

这是 H2

这是 H3

  1. 超链接 Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。 行内式一般使用较多。

3.1. 行内式: []里写链接文字,()里写链接地址, ()中的”“中可以为链接指定title属性,title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。

[链接文字](链接地址“链接标题”)这样的形式。
链接地址与链接标题前有一个空格。
注:链接路径可为绝对路径,也可为相对路径。

例:
欢迎来到百度
欢迎来到百度

3.2. 参考式

参考式超链接一般用在学术论文上面,或者另一种情况,如果某一个链接在文章中多处使用,那么使用引用 的方式创建链接将非常好,它可以让你对链接进行统一的管理。

参考式链接分为两部分,文中的写法

[链接文字][链接标记],在文本的任意位置添加[链接标记]:链接地址 “链接标题”,链接地址与链接标题前有一个空格。 
如果链接文字本身可以做为链接标记,你也可以写成[链接文字][] 
[链接文字]:链接地址的形式,见代码的最后一行。

经常去的几个网站 Google 、Leanote以及百度

[百度][3]是一个不错的[网站][]。
(1):http://www.google.com "Google"
[2]:http://www.leanote.com "Leanote"
[3]:http://baidu.com "百度"
[网站]:http://baidu.com

3.3. 自动链接

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

例:
http://example.com/
address@example.com

  1. 锚点
    网页中,锚点其实就是页内超链接,也就是链接本文档内部的某些元素,实现当前页面中的跳转。比如我这里写下一个锚点,点击回到目录,就能跳转到目录。 在目录中点击这一节,就能跳过来。还有下一节的注脚。这些根本上都是用锚点来实现的。
    目录{#index}
    跳转到目录

  2. 列表 5.1. 无序列表
    使用 *,+,- 表示无序列表。

  • 无序列表项 一
  • 无序列表项 二
  • 无序列表项 三

5.2. 有序列表 有序列表则使用数字接着一个英文句点。

  1. 有序列表项 一
  2. 有序列表项 二
  3. 有序列表项 三

5.3. 定义型列表
定义型列表由名词和解释组成。一行写上定义,紧跟一行写上解释。解释的写法:紧跟一个缩进(Tab)

Markdown
轻量级文本标记语言,可以转换成html,pdf等格式(左侧有一个可见的冒号和四个不可见的空格) 代码块 2
这是代码块的定义(左侧有一个可见的冒号和四个不可见的空格) 代码块(左侧有八个不可见的空格)

5.4. 列表缩进

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

要让列表看起来更漂亮,你可以把内容用固定的缩进整理好(显示效果与代码一致):

  • 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。 软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
  • 那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。 但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥! 悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。

5.5. 包含段落的列表

列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符(显示效果与代码一致)
  • 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。 那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。 软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!

    那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。 寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。 但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!

  • 悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。

5.5. 包含引用的列表

如果要在列表项目内放进引用,那 > 就需要缩进。
  • 阅读的方法:

    打开书本。
    打开电灯。

5.6. 包含代码区块的引用
包含代码区块的引用

  • 一列表项包含一个列表区块:
    <代码写在这>
  1. 引用

    引用需要在被引用的文本前加上>符号。

这是一个有两段文字的引用,
无意义的占行文字1.
无意义的占行文字2.

无意义的占行文字3.
无意义的占行文字4.

Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :

这是一个有两段文字的引用,
无意义的占行文字1.
无意义的占行文字2.
无意义的占行文字3.
无意义的占行文字4.

6.1. 引用的多层嵌套

区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > 。

请问 Markdwon 怎么用? - 小白

自己看教程! - 愤青

教程在哪? - 小白

6.2. 引用其它要素

引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等。
  1. 这是第一行列表项。
  2. 这是第二行列表项。

给出一些例子代码:

return shell_exec("echo $input | $markdown_script");
  1. 插入图像

    图片的创建方式与超链接相似,而且和超链接一样也有两种写法,行内式和参考式写法。

    语法中图片Alt的意思是如果图片因为某些原因不能显示,就用定义的图片Alt文字来代替图片。 图片Title则和链接中的Title一样,表示鼠标悬停与图片上时出现的文字。 Alt 和 Title 都不是必须的,可以省略,但建议写上。

7.1. 行内式
![图片Alt](图片地址 “图片Title”)

image

7.2. 参考式
在文档要插入图片的地方写![图片Alt][标记]
在文档的最后写上[标记]:图片地址 “Title”

美丽花儿: ico

  1. 表格

    1. 不管是哪种方式,第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。

    2. 列于列之间用管道符|隔开。原生方式的表格每一行的两边也要有管道符。

    3. 第二行还可以为不同的列指定对齐方向。默认为左对齐,在-右边加上:就右对齐。

      简单方式写表格:

      学号姓名分数
      小明75
      小红79
      小陆92

      原生方式写表格:

      学号姓名分数
      小明75
      小红79
      小陆92

      为表格第二列指定方向:

      产品价格
      Leanote 高级账号60元/年
      Leanote 超级账号120元/年
  2. 分隔线
    可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线。






  1. 代码
    对于程序员来说这个功能是必不可少的,插入程序代码的方式有两种,一种是利用缩进(Tab), 另一种是利用”`”符号(一般在ESC键下方)包裹代码。

    1. 插入行内代码,即插入一个单词或者一句代码的情况,使用code这样的形式插入。
    2. 插入多行代码,可以使用缩进或者“code “,具体看示例。
      注意: 缩进式插入前方必须有空行

对应的markdown脚本如下:
Markdown---易读易写

HTML是一种发布的格式,Markdown是一种书写的格式。Markdown的格式语法只涵盖纯文本的范围。

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。添加HTML区块元素标签,需要在其标签前后加上空行与其他内容区分开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。

这是一个普通段落。 

<h1>Hello world!</h1>  
<p>Plain text</p>

这是另一个普通段落。

注:以下图片中,图左markdown编码,图中效果,图右html编码。

1. [斜体和粗体](#ib)
2. [分级标题](#headline)
3. [超链接]()  
3.1. [行内式]()  
3.2. [参考式]()  
3.3. [自动链接]()  
4. [锚点]()
5. [列表]()  
5.1. [无序列表]()  
5.2. [有序列表]()  
5.3. [定义型列表]()  
5.4. [列表缩进]()  
5.5. [包含段落的列表]()  
5.6. [包含引用的列表]()  
5.7. [包含代码区块的引用]()  
6. 引用
6.1. 引用的多层嵌套
6.2. 引用其它要素
7. 插入图像  
7.1. 行内式  
7.2. 参考式  
8. 表格
9. 分隔线
10. 代码  


1. 斜体和粗体

*  斜体:将需要设置为斜体的文字两端使用1个“*”或者“_”夹起来
*  粗体:将需要设置为斜体的文字两端使用2个“*”或者“_”夹起来  
  
   *斜体*或_斜体_  
   **粗体**   
   ***加粗斜体***  
   ~~删除线~~ 

![image](http://note.youdao.com/yws/api/personal/file/2F15DE2CE926401682446EC7F5AA2251?method=download&shareKey=a0a5c39003a8d261492b35c8f5554bf8)

2. 分级标题 {#headline}  
    Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。  
    2.1.类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),如下:

This is an H1
=============

This is an H2
-------------
![image](http://note.youdao.com/yws/api/personal/file/832C08C7AB8441DBA30CAEDBB4CA4F99?method=download&shareKey=c285a177c603b3f875359b35e51b66fa)

2.2. 类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,如下:

# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######

3. 超链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。 行内式一般使用较多。   

3.1. 行内式: []里写链接文字,()里写链接地址, ()中的”“中可以为链接指定title属性,title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。  

    [链接文字](链接地址“链接标题”)这样的形式。
    链接地址与链接标题前有一个空格。
    注:链接路径可为绝对路径,也可为相对路径。
例:  
欢迎来到[百度](http://blog.leanote.com/freewalk)  
欢迎来到[百度](http://blog.leanote.com/freewalk "百度") 


3.2. 参考式  

    参考式超链接一般用在学术论文上面,或者另一种情况,如果某一个链接在文章中多处使用,那么使用引用 的方式创建链接将非常好,它可以让你对链接进行统一的管理。   
参考式链接分为两部分,文中的写法   

    [链接文字][链接标记],在文本的任意位置添加[链接标记]:链接地址 “链接标题”,链接地址与链接标题前有一个空格。 
    如果链接文字本身可以做为链接标记,你也可以写成[链接文字][] 
    [链接文字]:链接地址的形式,见代码的最后一行。

经常去的几个网站 [Google](1)    、[Leanote](2)以及[百度](3)

[百度][3]是一个不错的[网站][]。  
(1):http://www.google.com "Google"  
[2]:http://www.leanote.com "Leanote"  
[3]:http://baidu.com "百度"  
[网站]:http://baidu.com


3.3. 自动链接  

    Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用<>包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样。 
例:  
<http://example.com/>  
<address@example.com>

4. 锚点  
网页中,锚点其实就是页内超链接,也就是链接本文档内部的某些元素,实现当前页面中的跳转。比如我这里写下一个锚点,点击回到目录,就能跳转到目录。 在目录中点击这一节,就能跳过来。还有下一节的注脚。这些根本上都是用锚点来实现的。  
目录{#index}  
跳转到[目录](#index)

5. 列表
5.1. 无序列表  
   使用 *,+,- 表示无序列表。

- 无序列表项 一
- 无序列表项 二
- 无序列表项 三

5.2. 有序列表
有序列表则使用数字接着一个英文句点。

1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三

5.3. 定义型列表  
定义型列表由名词和解释组成。一行写上定义,紧跟一行写上解释。解释的写法:紧跟一个缩进(Tab)

Markdown
:    轻量级文本标记语言,可以转换成html,pdf等格式(左侧有一个可见的冒号和四个不可见的空格)
代码块 2
:   这是代码块的定义(左侧有一个可见的冒号和四个不可见的空格)
        代码块(左侧有八个不可见的空格)

5.4. 列表缩进  

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

要让列表看起来更漂亮,你可以把内容用固定的缩进整理好(显示效果与代码一致):

*   轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。 软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!   
*   那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。 但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥! 悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。

5.5. 包含段落的列表 

    列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符(显示效果与代码一致)

*   轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。 那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。 软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!

    那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。 但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!

*   悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。


5.5. 包含引用的列表

    如果要在列表项目内放进引用,那 > 就需要缩进。  

*   阅读的方法:
    > 打开书本。  
    > 打开电灯。

5.6. 包含代码区块的引用  
包含代码区块的引用

*   一列表项包含一个列表区块:  
        <代码写在这>


6. 引用  

    引用需要在被引用的文本前加上>符号。

> 这是一个有两段文字的引用,  
> 无意义的占行文字1.  
> 无意义的占行文字2.  
>   
> 无意义的占行文字3.  
> 无意义的占行文字4.  

    Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :

> 这是一个有两段文字的引用,  
无意义的占行文字1.  
无意义的占行文字2.  
> 无意义的占行文字3.  
无意义的占行文字4.
 
6.1. 引用的多层嵌套  

    区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > 。

>>> 请问 Markdwon 怎么用? - 小白  
>
>>  自己看教程! - 愤青  
>
>   教程在哪? - 小白 

6.2. 引用其它要素  

    引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等。
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码:
> 
>     return shell_exec("echo $input | $markdown_script");

7. 插入图像  

    图片的创建方式与超链接相似,而且和超链接一样也有两种写法,行内式和参考式写法。

    语法中图片Alt的意思是如果图片因为某些原因不能显示,就用定义的图片Alt文字来代替图片。 图片Title则和链接中的Title一样,表示鼠标悬停与图片上时出现的文字。 Alt 和 Title 都不是必须的,可以省略,但建议写上。
    
7.1. 行内式  
![图片Alt](图片地址 “图片Title”)  

![image](http://note.youdao.com/favicon.ico)

7.2. 参考式  
在文档要插入图片的地方写![图片Alt][标记]  
在文档的最后写上[标记]:图片地址 “Title”  

美丽花儿:
![ico][flower]  

[flower]:http://note.youdao.com/favicon.ico  "ico"

8. 表格
    1. 不管是哪种方式,第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。
    2. 列于列之间用管道符|隔开。原生方式的表格每一行的两边也要有管道符。
    3. 第二行还可以为不同的列指定对齐方向。默认为左对齐,在-右边加上:就右对齐。
    
        简单方式写表格: 

         学号|姓名|分数  
          -|-|-  
         小明|男|75
         小红|女|79
         小陆|男|92
         
         原生方式写表格:  
         
        |学号|姓名|分数|  
        |-|-|-|  
        |小明|男|75|  
        |小红|女|79|  
        |小陆|男|92|  
        
        为表格第二列指定方向:  
        产品|价格
        -|-:
        Leanote 高级账号|60元/年
        Leanote 超级账号|120元/年
        
9. 分隔线        
可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线。

* * *
***
*****
- - -
---------------------------------------

10. 代码  
对于程序员来说这个功能是必不可少的,插入程序代码的方式有两种,一种是利用缩进(Tab), 另一种是利用”`”符号(一般在ESC键下方)包裹代码。

    1. 插入行内代码,即插入一个单词或者一句代码的情况,使用`code`这样的形式插入。
    2. 插入多行代码,可以使用缩进或者“` code “`,具体看示例。  
    注意: 缩进式插入前方必须有空行




作者:星辰 时间:2017-06-18 浏览 782评论 0 赞 0砸 0 标签: 编辑器 工具
评论
还可以再输入500个字

请您注意

·自觉遵守:爱国、守法、自律、真实、文明的原则
·尊重网上道德,遵守《全国人大常委会关于维护互联网安全的决定》及中华人民共和国其他各项有关法律法规
·严禁发表危害国家安全,破坏民族团结、国家宗教政策和社会稳定,含侮辱、诽谤、教唆、淫秽等内容的作品
·承担一切因您的行为而直接或间接导致的民事或刑事法律责任
·您在NoteShare上发表的作品,NoteShare有权在网站内保留、转载、引用或者删除
·参与本评论即表明您已经阅读并接受上述条款