Markdown入门指南

Markdown 的目标是实现「易读易写」。

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


Markdown官方文档

Markdown基础语法

区块元素

1. 标题

标题是每篇文章都需要也是最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只要在这段文字前加 # 号即可。

# 一级标题

## 二级标题

### 三级标题

2. 区块引用

如果你需要引用一小段别处的句子,那么就要用引用的格式。

例如这样

只需要在文本前加入 > 这种尖括号(大于号)即可

3. 列表

Markdown支持有序列表和无序列表。

在 Markdown 下,列表的显示只需要在文字前加上 -* 即可变为无序列表,有序列表则直接在文字前加1. 2. 3. 符号要和文字之间加上一个字符的空格。

无序列表:

  • Ubuntu
  • Arch
  • Debian

有序列表:

  1. Ubuntu
  2. Arch
  3. Debian

4. 代码区块

要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以

比如这样

或者这样

5. 分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。

***
-—————-


区段元素

1. 链接

链接:[文字](网址 “标题”)

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。

不管是哪一种,链接文字都是用 [方括号] 来标记。

要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用"双引号"把 title 文字包起来即可

2. 强调

  Markdown 使用星号*和底线_作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用<em>标签包围,用两个 * 或 _ 包起来的话,则会被转成粗体

3. 代码

如果要标记一小段行内代码,你可以用反引号` 把它包起来,例如:

Use the printf() function.

4. 图片

图片:![文字](网址 “标题”)