Markdown语法学习笔记

[TOC]

Markdown
: 是一种电子邮件风格的标记语言,通常为程序员群体所使用。同时,Markdown支持嵌入html标签。

使用Markdown的好处

  1. 兼顾了[什么人都能打开]和[样式],由于是纯文本,Markdown文稿也不会因为未来的软件升级而产生不同版本之间的兼容问题和样式预览不一致的问题。
  2. 让你专注于写作的文字而不是排版。
  3. Markdown转HTML非常方便,HTML是整个万维网(WEB)的标记语言,更重要的是,它也是目前主流电子书格式所用的标记语言,采用Markdown进行文章的编辑,对于日后的文件转换工作也大有裨益。
  4. Markdown的标记语法有极好的可读性。

兼容HTML

  1. Markdown语法的目标是成为一种适用于网络的书写语言,Markdown不是想要取代HTML。
  2. Markdown的理念是,能让文档更容易读、写、改。HTML是一种发布的格式,Markdown是一种书写的格式,Markdown的格式语法只涵盖纯文本可以涵盖的范围。
  3. 不在Markdown涵盖范围之内的标签,都可以直接在文档里面用HTML撰写。不需要额外标注这是HTML或是Markdown,只要直接加标签即可。
  4. 在HTML区块标签间的Markdown格式语法将不会被处理。
  5. HTML的行内标签如<span><cite><del>可以在Markdown的段落、列表或是标题里随意使用。如果比较喜欢HTML的<a><img> 标签,可以直接使用这些标签,而不用Markdown提供的链接或是图像标签语法。

Markdown的常用语法介绍:

标题

Markdown标题标记支持两种形式,常用的#标记形式和=-标记形式(注意:=-标记形式,只支持第一级和第二级标题,后续标题不再支持)。

标题形式一

在需要设置为标题的文字前面加上#号并空格,Markdown的#标记形式支持一级标题、二级标题、三级标题、四级标题、五级标题、六级标题,总共六级,标题字号相应降低。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

显示效果:<br />
# 一级标题<br />
## 二级标题<br />
### 三级标题<br />
#### 四级标题<br />
##### 五级标题<br />
###### 六级标题<br />

标记形式二(只支持第一级和第二级标题)

标题文字下一行加上任意个=表示第一级标题,加上任意个-表示第二级标题。

# 一级标题
一级标题
=

## 二级标题
二级标题
-

显示效果:

# 一级标题
一级标题
=

## 二级标题
二级标题
-

由于用了[TOC]标记编辑器会把所有标题写到目录大纲中,在这里写的演示标题也会列进去,所以就不演示了。

注:# 和「一级标题」之间建议保留一个字符的空格,这是最标准的Markdown写法。

列表

无序列表

列表格式也很常用,在Markdown中,你只需要在列表文字前面加上+-*并空格即可。

+ 文本1
+ 文本2
+ 文本3

显示效果:

  • 文本1
  • 文本2
  • 文本3
- 文本1
- 文本2
- 文本2

显示效果:

  • 文本1
  • 文本2
  • 文本2
* 文本1
* 文本2
* 文本3

显示效果:

  • 文本1
  • 文本2
  • 文本3
有序列表

如果你希望是有序列表,可以在列表文字前面加上1. 2. 3. 或者 1. 1. 1. 甚至 1. 7. 5.并与文字之间有一个空格即可。

1. 文本1
2. 文本1
3. 文本1

显示效果:

  1. 文本1
  2. 文本1
  3. 文本1
1. 文本1
1. 文本1
1. 文本1

显示效果:

  1. 文本1
  2. 文本1
  3. 文本1
1. 文本1
7. 文本1
5. 文本1

显示效果:

  1. 文本1
  2. 文本1
  3. 文本1

注:

  1. -1.和文本之间要保留一个字符的空格,这是最标准的Markdown写法。
  2. 有序列表,会使用第一行的数字作为开始项,如:7.在第一行,默认就以7作为序列的开始。
定义型列表

定义型列表
: 定义型列表由名词和解释组成,第一行写上定义,紧跟一行写上解释。解释的写法:后面紧跟一个缩进[Tab]。

Markdown
:   Markdown是轻量级文本标记语言,可以转换成Html、Pdf等格式。   // 左侧有一个可见的冒号和四个不可见的空格(`:` `Tab`)

文字代码块
:   如下方式是对代码块的定义      // 左侧有一个可见的冒号和四个不可见的空格(`:` `Tab`)

        文字代码块      // 左侧有八个不可见的空格,即两个`Tab`键。
        public static void main(String[] args){
            System.out.println("Hello World!!!");
        }

显示效果:

Markdown
: Markdown是轻量级文本标记语言,可以转换成Html、Pdf等格式。 // 左侧有一个可见的冒号和四个不可见的空格(: Tab

文字代码块
: 如下方式是对代码块的定义 // 左侧有一个可见的冒号和四个不可见的空格(: Tab

    文字代码块      // 左侧有八个不可见的空格,即两个`Tab`键。
    public static void main(String[] args){
        System.out.println("Hello World!!!");
    }

编码代码块

public static void main(String[] args){
    System.out.println("Hello World!!!");
}
列表缩进

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

包含段落的列表

列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符。

超链接

普通超链接

在Markdown中,插入链接不需要用其他按钮,你只需要使用[显示文本](链接地址)或者[显示文本](链接地址 "鼠标悬浮文字")这样的语法即可。

Welcome to [Rambo科技无限空间](http://www.rambo123.com)
Welcome to [Rambo科技无限空间](http://www.rambo123.com "Rambo科技无限空间")

显示效果:

Welcome to Rambo科技无限空间 <br />
Welcome to Rambo科技无限空间

自动超链接

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

<http://www.rambo123.com>
<adress@rambo1203@sina.com>

显示效果:

http://www.rambo123.com <br />
rambo1203@sina.com

参考式超链接

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

语法说明:

  1. 参考式链接分为两部分,文中的写法 [链接文字][链接标记],在文本的任意位置添加[链接标记]:链接地址 “链接标题”,链接地址与链接标题中间有一个空格。

  2. 如果链接文字本身可以做为链接标记,你也可以写成[链接文字][]
    [链接文字]:链接地址的形式,见示例的最后一行。

代码片段:

我经常去的几个网站[Google][1]、[Leanote][2]以及[自己的网站][3]
[Leanote 笔记][2]是一个不错的[网站][]。

[1]:http://www.google.com "Google"
[2]:http://www.leanote.com "Leanote"
[3]:http:/www.rambo123.com "Rambo科技无限空间"
[网站]:http://blog.leanote.com/freewalk

显示效果:

我经常去的几个网站GoogleLeanote以及自己的网站
Leanote 笔记是一个不错的网站

插入网络图片

在Markdown中,插入图片不需要其他按钮,你只需要使用[图片上传失败...(image-6f083-1515913533862)]这样的语法即可。

![](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1515838217861&di=247e346671a85c14290807e2ef2cc087&imgtype=0&src=http%3A%2F%2Fimg.9553.com%2Fuploadfile%2F2016%2F0111%2F20160111010743581.jpg)

显示效果:

[图片上传失败...(image-50947e-1515913533862)]

注:插入图片的语法和链接的语法很像,只是前面多了一个 !

文字引用

在我们写作的时候经常需要应用他人的文字,这个时候应用这个格式就很有必要了,在Markdown中,你只需要在你希望引用的文字签名加上>并和该文字有一个空格即可。

> 一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

显示效果:

一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

注:> 和文本之间要保留一个字符的空格,这是最标准的Markdown写法。

代码引用

需要应用代码时,如果引用的语句只有一段,不分行,可以用 ` 将语句包起来。如果引用的语句为多行,可以将 ``` 置于这段代码的首行和末行,其中首行可以指定引用代码的语言,Markdown支持该语法的高亮支持。

单行代码引用

Hello World!

多行代码引用
public static void main(String[] args){
    System.out.println("Hello World!!!");
}

综合引用

引用用>表示,应用支持多级引用、标题、列表、代码块、分割线等常规语法。

常见的引用写法

---
> 这是一段引用          // 在`>`后面有一个空格
>
>     这是引用的代码块形式          // 在`>`后面有五个空格
>
> 代码例子
>
     public static void main(String[] args){
         System.out.println("Hello World!!!");
     }
---

---
> 一级引用
> > 二级引用            // 每个`>`后面都有一个空格
> > > 三级引用          // 每个`>`后面都有一个空格

> #### 这是一个四级标题
>
> 1. 这是引用中的有序列表项第一行
> 2. 这是引用中的有序列表项第二行
>
---

> 以下是分割线
***

显示效果:


这是一段引用 // 在>后面有一个空格

这是引用的代码块形式          // 在`>`后面有五个空格

代码例子

 public static void main(String[] args){
     System.out.println("Hello World!!!");
 }


一级引用

二级引用 // 每个>后面都有一个空格

三级引用 // 每个>后面都有一个空格

这是一个四级标题

  1. 这是引用中的有序列表项第一行
  2. 这是引用中的有序列表项第二行

以下是分割线


粗体、斜体删除线

Markdown在粗体和斜体也非常简单,用**或者__包含一段文本就是粗体的语法,用*或者_包含一段文本就是斜体的语法,用***或者___包含一段文本就是加粗斜体。Markdown的删除线则采用~~包含一段文本即可。

**我是粗体**
__我是粗体__

显示效果:

我是粗体
我是粗体

*我是斜体*
_我是斜体_

显示效果:

我是斜体
我是斜体

***我是加粗斜体***
___我是加粗斜体___

显示效果:

我是加粗斜体
我是加粗斜体

~~删除线~~

显示效果:

删除线

注:但是如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。

表格

表格对齐格式:

  • 居左(默认对齐方式): :----
  • 标题居中,内容居中: :----:
  • 标题居中,内容居左: ----
  • 居右: ----:

相关代码1:

| 标题和内容居左               | 标题和内容居中               | 标题居中内容居左                 | 标题和内容居右               |
| :--------------------------- | :--------------------------: | -------------------------------- | ---------------------------: |
| 居左                         | 居中                         | 居中和居左                       | 居右                         |
| 标题和内容居左               | 标题和内容居中               | 标题居中内容居左                 | 标题和内容居右               |
| 标题和内容居左标题和内容居左 | 标题和内容居中标题和内容居中 | 标题居中内容居左标题居中内容居左 | 标题和内容居右标题和内容居右 |

显示效果1:

标题和内容居左 标题和内容居中 标题居中内容居左 标题和内容居右
居左 居中 居中和居左 居右
标题和内容居左 标题和内容居中 标题居中内容居左 标题和内容居右
标题和内容居左标题和内容居左 标题和内容居中标题和内容居中 标题居中内容居左标题居中内容居左 标题和内容居右标题和内容居右

相关代码2(无格式):

dog | bird | cat
----|------|----
foo | foo  | foo
bar | bar  | bar
baz | baz  | baz

显示效果2:

dog bird cat
foo foo foo
bar bar bar
baz baz baz

分隔线

你可以在一行中连续不间断(如有间断,中间必须是空格)使用三个或以上的*-_来建立分隔线。


***

---

___

* * * 

- - - 

_ _ _


显示效果:







特殊符号转译

Markdown支持以下这些特殊字符通过在符号前面加上反斜杠来帮助插入普通的符号。

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

显示效果:

\ 反斜线

` 反引号

* 星号

_ 底线

{} 花括号

[] 方括号

() 括弧

# 井字号

+ 加号

- 减号

. 英文句点

! 惊叹号

锚点

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

注意:

  1. Markdown Extra 只支持在标题后插入锚点,其它地方无效。
  2. Leanote 编辑器右侧显示效果区域暂时不支持锚点跳转,所以点来点去发现没有跳转不必惊慌,但是你发布成笔记或博文后是支持跳转的。

代码片段:

## 0. 目录{#index}
***
***
此处省略一万字
***
***
跳转到[目录](#index)

换行

普通换行

在行尾添加两个空格加回车表示换行操作。

这是一行后面加了两个空格后回车的  
换行

显示效果:

这是一行后面加了两个空格后回车的
换行

空行换行

在行尾连续两次敲击回车表示下一行空行并在第三行开始输入操作。

这是一行后面连续两次敲击回车的

空行换行

显示效果:

这是一行后面连续两次敲击回车的

空行换行

脚注

脚注是写文章时的一种格式:对正文中的某些问题需加以说明时,可用“呼应注”(也叫脚注),即在所要加注处的右上角标注“①、②……”,同时在本页末留出位置,划一横线与正文隔开,在横线下注明“①、②……”。

脚注的定义:

使用[^]来定义脚注。

脚注[^A]
[^A]: 这是一个脚注解释内容

显示效果:

脚注[1]

常用弥补Markdown的Html标签

字体
<font face="微软雅黑" color="red" size="3">字体及字体颜色和大小</font>
<font color="#0000ff">字体颜色</font>

显示效果:

<font face="微软雅黑" color="red" size="3">字体及字体颜色和大小</font>
<font color="#0000ff">字体颜色</font>

换行
使用html标签`<br/>`<br/>换行

显示效果:

使用html标签<br/>
换行

文本对齐方式
<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>

显示效果:

<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>

下划线
<u>下划线文本</u>

显示效果:

<u>下划线文本</u>


  1. 这是一个脚注解释内容

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