Markdown语法整理

留下参考吧,这个是使用windows下的MarkdownPad2,github离线风格写的,放在这里这个文章内部链接跳转手失败,真麻烦
现在这个markdown的语法五花八门的,用着真蛋疼,本来很简单的语法非要搞得这么蛋疼,如果windows下使用MarkdownPad的朋友的可以看下,其他的随意把,兵在精而不再多,完好一种就行了,这样办起事来利索,至于其他的有时间、有兴趣了就折腾下吧。
<h1 id="0">Markdown语法整理</h1>

说明:本文中中语法里面的代码就是需要写的Markdown语法,展示效果就是最后生成的页面
此语法编写和测试环境:windows上使用MarkdownPad2的GitHub离线风格的Markdown语法,使用在线风格好像不支持文章内部链接跳转

<h2 id="1">一.分级目录</h2>

语法:

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

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

展示效果:

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

<h2 id="2">二.斜体与粗体</h2>

语法:

*斜体*
**粗体**

展示效果:

斜体
粗体

<h2 id="3">三.超链接</h2>

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

<h4 id="4">3.1.行内式:</h4>

语法:

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

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

展示效果:

打开百度
打开百度

<h4 id="5">3.2.参考式:</h4>

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

语法:

  我经常浏览的几个网站[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和看视频的网站爱奇艺感觉都是很不错的网站.

<h4 id="6">3.3.自动连接:</h4>

语法:

   <http://www.baidu.com/>
   <admin@baidu.com>

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

展示效果:

http://www.baidu.com/
admin@baidu.com

<h2 id="7">四.锚点</h2>

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

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

<h4 id="8">4.1.页内超链接:</h4>

语法:

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

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

展示效果:

1.分级目录{#index}

跳转到1.分级目录

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

<h4 id="9">4.2.文章内部标题链接:</h4>

语法:

* [目录1](#40)
   * [标题1](#41)
   * [标题2](#42)
   * [标题3](#43)
   * [标题4](#44)
  
<h3 id="41">标题1</h3>
    轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
<h3 id="42">标题2</h3>
    正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
<h3 id="43">标题3</h3>
    我轻轻的招手, 作别西天的云彩。
<h3 id="44">标题4</h3>
    作别西天的云彩。

展示效果:

<h3 id="41">标题1</h3>
轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
<h3 id="42">标题2</h3>
正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
<h3 id="43">标题3</h3>
我轻轻的招手, 作别西天的云彩。
<h3 id="44">标题4</h3>
作别西天的云彩。

<h2 id="10">五.列表</h2>

<h4 id="11">5.1.无需列表:</h4>

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

语法:

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

展现效果:

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

<h4 id="12">5.2.有序列表:</h4>

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

语法:

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

展现效果:

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

<h4 id="13">5.3.定义型列表:</h4>

语法:

  名词1
  :    定义 1(左侧有一个可见的冒号和四个不可见的空格)

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

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

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

展现效果:

名词1
: 定义 1(左侧有一个可见的冒号和四个不可见的空格)

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

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

<h4 id="14">5.4.列表缩进:</h4>

语法:

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

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

效果:

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

<h4 id="15">5.5.包含段落的列表:</h4>

语法:

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

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

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

效果:

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

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

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

<h4 id="16">5.6.任务列表:</h4>

要创建任务列表,前缀列表项[ ]。要将任务标记为完整,请使用[x]

语法:

  - [] 跑步
  - [] 骑车
  - [x] 吃饭
  - [] 睡觉

展现效果:

  • [ ] 跑步
  • [ ] 骑车
  • [x] 吃饭
  • [ ] 睡觉

<h2 id="17">六.表格</h2>

<h4 id="18">6.1.竖杠|下划线-写法:</h4>

使用竖杠|下划线-写法

语法:

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

展现效果:

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

<h4 id="19">6.2.html写法:</h4>

使用<table> <tr> <td> </td> </tr> </table>

语法:

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

展现效果:

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

这里是因为使用github离线风格导致空格,使用在线就没有了。这里简书不支持,没辙,先留下吧

<h2 id="20">七.创建和突出显示代码块</h2>

<h4 id="21">7.1.栅栏代码块:</h4>

语法:

 ```

   function test() {
     console.log(“在此函数之前注意空白行?");
   }

```

展现效果:

       function test() {
         console.log("在此函数之前注意空白行?");
       }

<h4 id="22">7.2.语法高亮显示:</h4>

高亮度需要使用github在线风格才能显示颜色

语法:

```ruby
   require 'redcarpet'
   markdown = Redcarpet.new("Hello World!")
   puts markdown.to_html
```

展现效果:

ruby语法:

       require 'redcarpet'
       markdown = Redcarpet.new("Hello World!")
       puts markdown.to_html

python语法:

def foo():
    if not bar:
        return True

本文使用的markdownPad2需要使用github在线markdown风格才会显示,其他不显示。

<h4 id="23">7.3.引用代码:</h4>

您可以使用单个反引号来调用句子中的代码或命令。反引号内的文本将不被格式化。

语法:

 Use `git status` to list all new or modified files that haven't yet been committed.

展现效果:

Use git status to list all new or modified files that haven't yet been committed.

<h4 id="24">7.4.引用文字:</h4>

你可以用引用文本>.

语法:

In the words of Abraham Lincoln:

> Pardon my French

展现效果:

In the words of Abraham Lincoln:

Pardon my French

<h4 id="25">7.5.删除线:</h4>

语法:

~~This was mistaken text~~

展现效果:

This was mistaken text

跳转至首页
使用window下的MarkdownPad2的GitHub离线Markdown语法效果页面请看这里:https://guo365.github.io/study/Markdown.html#0

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,029评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,395评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,570评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,535评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,650评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,850评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,006评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,747评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,207评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,536评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,683评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,342评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,964评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,772评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,004评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,401评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,566评论 2 349

推荐阅读更多精彩内容

  • 1.markdown是一种编写html元素(大多与文本相关)的语法2.markdown语法能表示的html元素可分...
    Addy_Zhou阅读 4,743评论 0 4
  • 参考文章:献给写作者的 Markdown 新手指南优点: 纯文本,兼容性强,可在所有文本编辑器打开 专注于文字而不...
    流云012阅读 331评论 0 0
  • 2017-09-16 更新JIRA 用的是 textile 语法,与 markdown 不同,两者都属于 mark...
    卡拉赞图书馆阅读 10,868评论 3 4
  • (Markdown语法没有一个统一的标准,不同的工具或平台采用的标准不一样,所以有些语法规则和功能是有差异的) 0...
    迟道阅读 56,718评论 4 69
  • 读完此书,我首先要向这位伟大的作者致敬,感谢您写出如此精彩的小说,让我有幸领略这伟大的著作。 这本书,在引人入胜的...
    我是l谁阅读 571评论 8 8