Markdown语法整理

Markdown语法整理

说明:本文中中语法里面的代码就是需要写的Markdown语法,展示效果就是最后生成的页面
此语法编写和测试环境:windows上使用MarkdownPad2的GitHub风格的Markdown语法

一.分级目录

语法:

* 总目录
  * 一级目录
    * 二级目录
      * 三级目录

说明:层级列表一般只支持三级列表,第一级实心圆点,第二级空心圆点,第三级以后都是实心方点。要实现层级列表,每下一级都要比上一级多输入2个空格或者一个Tab,而且第一级前面不要超过3个空格.

展示效果:

  • 总目录

    • 二级目录
    • 三级目录
    • 一级目录

二.斜体与粗体

语法:

*斜体*
**粗体**

展示效果:

斜体
粗体

三.超链接

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

3.1.行内式:

语法:

    [打开百度](http://www.baidu.com)
    [打开百度](http://www.baidu.com "打开百度")

说明:[]里写链接文字,()里写链接地址, ()中的”“中可以为链接指定title属性,title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。[链接文字](链接地址 “链接标题”)这样的形式。链接地址与链接标题前有一个空格。

展示效果:

打开百度
打开百度

3.2.参考式:

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

语法:

  我经常浏览的几个网站[Google][1]、[Baidu][2]、[51CTO][3]和看视频的网站[爱奇艺][4]感觉都是很不错的[网站][].
  [1]:http://www.google.com "google"
  [2]:http://www.baidu.com "Baidu"
  [3]:http://www.51cto.com "51cto"
  [4]:http://www.aiqiyi.com "aiqiyi"
  [网站]:http://www.qq.com

展示效果:

我经常浏览的几个网站GoogleBaidu51CTO和看视频的网站爱奇艺感觉都是很不错的网站.


3.3.自动连接:

语法:

   <http://www.baidu.com/>
   <[email protected]>

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


展示效果:

http://www.baidu.com/

[email protected]


四.锚点

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

注意:Markdown Extra 只支持在标题后插入锚点,其它地方无效

4.1.页内超链接:

语法:

# 1.分级目录{#index}
  跳转到[标题]{#index}

说明:在你准备跳转到的指定标题后插入锚点{#标记},然后在文档的其它地方写上连接到锚点的链接。此处使用的是GitHub风格的Markdown语法所以无法正常显示效果,推荐使用以下4.2.文章内部标题链接

展示效果:

1.分级目录{#index}

跳转到1.分级目录

说明:这里是在本文的分级目录设置的,不然效果不明显

4.2.文章内部标题链接:

语法:

* [目录1](#20)
   * [标题1](#21)
   * [标题2](#22)
   * [标题3](#23)
   * [标题4](#24)

<h3 id=‘21‘>标题1</h3>
    轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
<h3 id=‘22‘>标题2</h3>
    正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
<h3 id=‘23‘>标题3</h3>
    我轻轻的招手, 作别西天的云彩。
<h3 id=‘24‘>标题4</h3>
    作别西天的云彩。

展示效果:

标题1

轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。

标题2

正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。

标题3

我轻轻的招手, 作别西天的云彩。

标题4

作别西天的云彩。

五.列表

5.1.无需列表:

使用 *,+,- 表示无序列表

语法:

    - 无序列表一
    + 无序列表二
    * 无序列表三

展现效果:

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

5.2.有序列表:

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

语法:

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

展现效果:

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

5.3.定义型列表:

语法:

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

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

展现效果:

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

代码块 2
: 这是代码块的定义(左侧有一个可见的冒号和四个不可见的空格)

    代码块(左侧有八个不可见的空格)

5.4.列表缩进:

语法:

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

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

效果:

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

5.5.包含段落的列表:

语法:

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

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

说明:
列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符(显示效果与代码一致):如果你每行都有缩进,看起来会看好很多,当然,再次地,如果你很懒惰,Markdown 也允许

效果:

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

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

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

六.表格

6.1.竖杠|下划线-写法:

语法:

  |名字|性别|年龄|国籍|
  |-----------------|
  |张三|男|23|中国|
  |小红|女|18|中国|
  |Tom|男|46|美国|

展现效果:

名字 性别 年龄 国籍
张三 23 中国
小红 18 中国
Tom 46 美国

6.2.htmltable写法:

语法:

 <table>
       <tr>
           <td>车次</td>
           <td>开车时间</td>
           <td>到达时间</td>
        </tr>
        <tr>
            <td>D110</td>
            <td>10:22</td>
            <td>11:00</td>
        </tr>
 </table>

展现效果:

车次 开车时间 到达时间
D110 10:22 11:00

说明:这里有点奇怪,为什么那么大空格,目前没有找到原因,跳转至首页

因为Markdown语法简洁明了,在日常整理文档时很不错,就网上搜索,经过自己整理验证,贡献出来,以便需要的网友们参考,如果文档中有错误的,或者看着不明了的,希望留言,以便纠正

时间: 2024-11-03 10:29:56

Markdown语法整理的相关文章

Markdown 语法整理

白宁超 2015年7月24日14:57:49 一.字体设置 A First Level Header == A Second Level Header -- # 标题 ## 标题 ### 标题 #### 标题 ##### 标题 ###### 标题 注:换行 两个空格 二.修辞和强调 Markdown 使用星号和底线来标记需要强调的区段. 加粗: **Blod** 标亮: 请把我标亮` 请把我标亮 一级列表: - dd rrrrrrrrrrr - ee eeeeeeeeeeeee 1.eee rr

Markdown 语法说明

NOTE: This is Simplelified Chinese Edition Document of Markdown Syntax. If you are seeking for English Edition Document. Please refer to Markdown: Syntax. 声明: 这份文档派生(fork)于繁体中文版,在此基础上进行了繁体转简体工作,并进行了适当的润色.此文档用 Markdown 语法编写,你可以到这里查看它的源文件.「繁体中文版的原始文件可以

简体中国版文档的Markdown语法

Markdown文件 注意︰这是简体中国版文档的Markdown语法.如果你正在寻找英语版文档.请参阅Markdown︰ Markdown: Syntax. Markdown: Syntax 概述 哲学 行内 HTML 特殊字符自动转换 区块元素 段落和换行 标题 区块引言 清单 程序代码区块 分隔线 区段元素 连结 强调 程序代码 图片 其他 跳脱字符 自动连结 感谢 注意:这份文件是用Markdown写的,你可以看看它的原始档 . 概述 哲学 Markdown的目标是实现「易读易写」. 不过

Markdown 语法说明 (简体中文版)

<< [访问 Wow!Ubuntu](http://wowubuntu.com) **NOTE:** This is Simplelified Chinese Edition Document of Markdown Syntax. If you are seeking for English Edition Document. Please refer to [Markdown: Syntax][eng-doc]. [eng-doc]:http://daringfireball.net/pr

MarkDown语法简介

Markdown 语法简介 概述 宗旨 兼容 HTML 特殊字符自动转换 区块元素 段落和换行 标题 区块引用 列表 代码区块 分隔线 区段元素 链接 强调 代码 图片 其它 反斜杠 自动链接 感谢 Markdown 免费编辑器 概述 宗旨 Markdown 的目标是实现「易读易写」. 可读性,无论如何,都是最重要的.一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成.Markdown 语法受到一些既有 text-to-HTML 格

[转]Markdown 语法说明 (简体中文版)

NOTE: This is Simplelified Chinese Edition Document of Markdown Syntax. If you are seeking for English Edition Document. Please refer to Markdown: Syntax. 声明: 这份文档派生(fork)于繁体中文版,在此基础上进行了繁体转简体工作,并进行了适当的润色.此文档用 Markdown 语法编写,你可以到这里查看它的源文件.「繁体中文版的原始文件可以

Markdown语法 与 Hexo常用指令

Markdown语法 与 Hexo常用指令 Markdown Hexo Markdown是一种超轻量级的标记语言,常用的标记符号不超过十个,相对于更为复杂的HTML标记语言来讲,Markdown实在简便多了,因此学习成本也不是很大.更多关于Markdown的认识,我们可以参考:认识与入门 Markdown Markdown工具 关于支持Markdown的书写工具网络上有很多推荐,这里不再一一列举,常用的有: Mou:外文世界对 MarkDown 的热衷在 Mac 上可见一斑,目前虽是免费的,但功

.md文件 Markdown 语法说明

Markdown 语法说明 (简体中文版) / (点击查看快速入门) 概述 宗旨 兼容 HTML 特殊字符自动转换 区块元素 段落和换行 标题 区块引用 列表 代码区块 分隔线 区段元素 链接 强调 代码 图片 其它 反斜杠 自动链接 感谢 Markdown 免费编辑器 概述 宗旨 Markdown 的目标是实现「易读易写」. 可读性,无论如何,都是最重要的.一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成.Markdown 语法

Markdown语法手册

. 目录 0. 目录 1. 斜体和粗体 2. 分级标题 3. 超链接 3.1. 行内式 3.2. 参考式 3.3. 自动链接 4. 锚点 5. 列表 5.1. 无序列表 5.2. 有序列表 5.3. 定义型列表 5.3. 列表缩进 5.4. 包含段落的列表 5.5. 包含引用的列表 5.6. 包含代码区块的引用 5.7. 一个特殊情况 6. 引用 6.1. 引用的多层嵌套 6.2. 引用其它要素 7. 插入图像 7.1. 行内式 7.2. 参考式 8. 内容目录 9. 注脚 10. LaTeX