简介

Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia等网站,如各大博客平台:WordPress、Drupal、简书等。

初级教程

标题

1
2
3
4
# 一级标题
## 二级标题
### 三级标题
#### 四级标题

粗体

1
2
**粗体**
__粗体__

斜体

1
2
*粗体*
_粗体_

段落和换行

第一种方法:直接敲两个回车键
第二种方法:在写完一段之后,敲两个空格,然后再敲回车键
第三种方法:在写完一段之后,使用HTML的标记符 <br />作为换行符

分隔线

在一行中用三个及以上的星号(*)、减号(-)、等于号(=)或者下划线(_)来创建分隔线。

1
2
3
4
***
---
===
___

引言

1
2
> 这是一个引言
> 这是另一个引言 ( 标记 > 放到引用的语句最前面,需要注意的是每段的开头都要加 > 标记)

这是一个引言
这是另一个引言

无序列表

无序列表可以在每行开头用星号、加号、减号来表示,也可以三者混合一起,推荐使用相同的字符,避免混乱。

1
2
3
* 一朵百合花
* 两朵百合花
* 三朵百合花
  • 一朵百合花
  • 两朵百合花
  • 三朵百合花

有序列表

有序列表用数字接着一个英文句点来表示,数字可无序。

1
2
3
1. 一朵百合花
2. 两朵百合花
3. 三朵百合花
  1. 一朵百合花
  2. 两朵百合花
  3. 三朵百合花

插入代码

  • 插入单行代码,用一对反引号把代码引起来。
    1
    `这是一行代码`
  • 插入多行代码,用一对 三个连续的反引号把多行代码引起来。
    1
    2
    3
    4
    5
    6
    \`\`\`
    第一行代码(实际使用,去掉 \ )
    第二行代码
    ...
    第N行代码
    \`\`\`

    网址链接

    网址链接有两种方式:行内式、参考式。
    对于行内式,链接文字是用 [方括号] 来标记,网址是用 (括号) 来标记,Title是用 “双引号” 来标记的。
    1
    [Google](https://www.google.com.hk/webhp "Google")
    这是一个行内式的网址链接:Google

对于参考式,一般写法是:(注意下面的代码中间需要空一行)

1
2
3
4
5
这是一个参考式的网址链接:[Google][1]
这是另一个参考式网址链接:[Baidu][2]

[1]: https://www.google.com.hk/webhp
[2]: https://www.Baidu.com

这是一个参考式的网址链接:Google
这是另一个参考式网址链接:Baidu

在参考式中,还有一种隐式写法是:

1
2
3
4
5
这是一个参考式的网址链接:[Google][]
这是另一个参考式网址链接:[Baidu][]

[Google]: https://www.google.com.hk/webhp
[Baidu]: https://www.Baidu.com

这是一个参考式的网址链接:Google
这是另一个参考式网址链接:Baidu

图片链接

图片链接与上面的网址链接类似,同样有两种形式:行内式和参考式,只不过图片链接在前面加上一个感叹号 !

图片可以放在本地,也可以上传到一些云端,比如 SM.MS ,将图片上传到这个网站上,它会提供一个相应的链接。

  • 行内式

    1
    ![谷歌](https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_120x44dp.png "Google")

    谷歌

  • 参考式

    1
    2
    3
    ![谷歌][1]

    [1]: https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_120x44dp.png "Google"

    谷歌

Markdown文件开头格式

在Markdown的开头部分需要对文档做一些定义,比如文档的Tags、Categories、title、date等,如下:

1
2
3
4
5
6
---
title: 'Markdown 学习笔记'
date: 2019-06-02 17:12:44
tags: [Markdown, 编程, 教程]
categories: 标记语言
---