引用自：Te_Lee的 Markdown——入门指南

Markdown 是一种轻量级的「标记语言」，它的优点很多，目前也被越来越多的写作爱好者，撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑，Markdown 的语法十分简单。常用的标记符号也不超过十个，这种相对于更为复杂的 HTML 标记语言来说，Markdown 可谓是十分轻量的，学习成本也不需要太多，且一旦熟悉这种语法规则，会有一劳永逸的效果。

语法简要规则

标题

Markdown标题

每篇文章都离不开标题，层次分明的标题可以让文章的结构清晰明了，让读者能快速抓住行文脉络。

# 一级标题
## 二级标题
### 三级标题

以此类推，最多可以到六级标题，#号后的空格可加可不加，规范的写法是加上一个空格。

列表

Markdown列表

无序列表在文字需要前加上 - 或者 *；而有序列表则需要在文字前加上 1. ，注意空格，这里的数字1并不是固定写死的，使用任意数字都可以。

引用

Markdown引用

当你需要引用其他地方的一段文字时，需要用到引用的格式，在文本前加上 >。

青年的朝气倘已消失，前进不己的好奇心已衰退以后，人生就没有意义。 ——穆勒

图片与链接

Markdown图片与链接

插入链接与插入图片的语法很相似，区别在一个 ! 号。
图片： ![描述](url)
链接： [描述](url)

图片的地址一般需要图床工具或服务生成URL地址。

粗体与斜体

用两个*包含一段文本即可显示该段文本的黑体，类似的，用一个*或者_包含则可以显示斜体。

粗体 斜体

删除线

用两个~包含一段文本即可在该段文本上显示删除线。

标记删除的文本

代码框

Markdown代码框

用两个 ` 把中间的代码段包裹起来即可让代码段显示在代码框里。

Hello, world!

多行代码可以用三个 ` 前后包裹，加上编程语言类型可以使代码正确地显示语法高亮。

1
2
3
public static void main(String[] args) {
    System.out.println("Hello, world!");
}

使用tab进行缩进。

分割线

分割线的语法只需要三个*号。

表格

下面上表格语法的一个例子。

1
2
3
4
5
| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |
Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

折叠块

使用 <details> 标签表示一个可以折叠的块。

1
2
3
4
5
<details>
    <summary>折叠块展示的标题</summary>
    <p>折叠块的内容</p>
    Hello, Wrold!
</details>
折叠块展示的标题

折叠块的内容

Hello, Wrold!

GitHub的checkbox列表

在列表符号（即 - 或者 *）后面加上 [x] 或者 [ ]（注意中间的空格） 表示选中或者未选中的checkbox。

1
2
3
4
5
6
- [x] Java
- [x] JavaScript
- [x] HTML
- [x] CSS
- [ ] C++
- [ ] Go
  • Java
  • JavaScript
  • HTML
  • CSS
  • C++
  • Go

相关推荐

工具

Markdown编辑器

图床工具

下图介绍了图床的用途。

图床

文章

官方文档
创始人 John Gruber 的 Markdown 语法说明
Markdown 中文版语法说明