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的行内标签如可以在Markdown的段落、列表或是标题里随意使用。如果比较喜欢HTML的 标签,可以直接使用这些标签,而不用Markdown提供的链接或是图像标签语法。

Markdown的常用语法介绍:

标题

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

标题形式一

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

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

显示效果:

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

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

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

# 一级标题
一级标题
=

## 二级标题
二级标题
-

显示效果:

# 一级标题
一级标题
=

## 二级标题
二级标题
-

由于用了[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科技无限空间

Welcome to Rambo科技无限空间

自动超链接

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



显示效果:

http://www.rambo123.com

[email protected]

参考式超链接

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

语法说明:

  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

显示效果:

我经常去的几个网站Google、Leanote以及自己的网站
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标签

字体
字体及字体颜色和大小
字体颜色

显示效果:

字体及字体颜色和大小
字体颜色

换行
使用html标签`
`
换行

显示效果:

使用html标签

换行

文本对齐方式

居左文本

居中文本

居右文本

显示效果:

居左文本


居中文本


居右文本

下划线
下划线文本

显示效果:

下划线文本


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

你可能感兴趣的:(Markdown语法学习笔记)