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

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

# 语法简要规则

# 标题

Markdown标题

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

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

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

# 列表

Markdown列表

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

# 引用

Markdown引用

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

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

# 图片与链接

Markdown图片与链接

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

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

# 粗体与斜体

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

粗体 斜体

# 删除线

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

标记删除的文本

# 代码框

Markdown代码框

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

Hello, world!

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

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

使用tab进行缩进。

# 分割线

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


# 表格

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

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

# 折叠块

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

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

折叠块的内容

Hello, Wrold!

# GitHub的checkbox列表

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

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

# 相关推荐

# 工具

# Markdown编辑器

# 图床工具

下图介绍了图床的用途。

图床

# 文章

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