Markdown初体验

参考资料

• Writing on Github: Basic writing and formatting syntax
• Github Guides: Mastering Markdown
• Writing on GitHub: Working with advanced formatting
• markdown tutorial
• markdown preview for vim

语法

标题

在文本前面加1~6个井号(# )，可将文本变成1～6级标题。示例：

输入内容：

\#\#\#\# 四级标题  
\#\#\#\#\# 五级标题  
\#\#\#\#\#\# 六级标题

显示结果：

四级标题

五级标题

六级标题

样式

在文本前后各加一个下划线(_)，可将该文本变成斜体。
在文本前后各加两个星号(**)，可将该文本加粗。
在文本前后各加两个波浪号(~~)，可将该文本划掉。示例：

样式	输入内容	显示结果
斜体	_hello world_	hello world
加粗	**hello world**	hello world
划掉	~~hello world~~	hello world

链接

• 文本链接

用中括号[]括住链接文本，用小括号()括住URL地址即可。示例：

输入内容:

\[mastering MarkDown\]\(https://guides.github.com/features/mastering-markdown/\) 

显示结果：

mastering MarkDown

• 图片链接

与文本链接类似，区别是在中括号前要加一个感叹号(!)。示例：

输入内容：

\!\[cat\]\(http://octodex.github.com/images/octdrey-catburn.jpg\) 

显示结果:

引用

• 引用文本

在文本前面加上右箭头(>)，即可引用该文本。示例：

输入内容：

我喜欢尼采的一句话：
>凡不能毁灭我的，必将使我强大。

输出内容：

我喜欢尼采的一句话：

凡不能毁灭我的，必将使我强大。

• 引用代码

引用单行的少量代码，用一对反引号(``)括起来即可。示例：

输入内容：

Linux系统可以使用`shutdown now`命令来关机。

输出内容：

Linux系统可以使用shutdown now命令来关机。

引用多行的代码块，在代码块前面和后面分别加上三个反引号(```)即可。示例：

输入内容：

这是几乎所有初学C语言的同学都会接触过的一段代码：
```
int main()
{
printf("Hello world.\n");
return 0;
}
```

输出内容：

这是几乎所有初学C语言的同学都会接触过的一段代码：

int main()
{
  printf("Hello world.\n");
  return 0;
}

列表

• 无序列表

要把多行文本以无序列表方式显示，只需在每行文本前加上加号(+)、减号(-)或乘号(*)即可。示例：

输入内容：

- 费因曼
- 图灵
- 香农

输出内容：

• 费因曼
• 图灵
• 香农

• 有序列表

要把多行文本以有序列表显示，只需在每行文本前加上数字编号即可。示例：

输入内容：

1. 中国史纲
2. 乡土中国
3. 江村经济

输出内容：

1. 中国史纲
2. 乡土中国
3. 江村经济

• 嵌套列表

无序列表或有序列表均可嵌套，每一级嵌套需要缩进四个空格。

输入内容：

1. 文学
    1. 黄金时代
    2. 罪与罚
2. 哲学
    - 西方哲学史
    - 纯粹理性批判
    - 权力意志
3. 计算机科学

输出内容：

1. 文学
   1. 黄金时代
   2. 罪与罚
2. 哲学
   • 西方哲学史
   • 纯粹理性批判
   • 权力意志
3. 计算机科学

任务列表

在每项任务前加上中括号[]，即可创建任务列表。在中括号内填上x，则表示该任务已完成。示例：

输入内容：

- [x] 学习MardDown用法
- [ ] 使用MardDown写vim学习笔记
- [ ] 学习shell脚本基础

输出内容：

• 学习MardDown用法
• 使用MardDown写vim学习笔记
• 学习shell脚本基础

表格

要想创建一个表格，用竖杠(|)分开每行中的不同项，并在第一行后用横线分割一下即可。示例：

输入内容：

粤语歌 | 国语歌
------ | ------
明年今日 | 十年
富士山下 | 爱情转移

输出内容：

粤语歌	国语歌
明年今日	十年
富士山下	爱情转移

要想表格中某一列向左对齐，在横线左边加上冒号(😃；向右对齐，则在横线右边加上冒号；中间对齐，则在横线两边均加上冒号。示例：

输入内容：

左对齐 | 居中对齐 | 右对齐
 :---  | :---:    | ---:
 活着  | 活着     | 活着
 追忆似水年华 | 追忆似水年华 | 追忆似水年华

输出内容：

左对齐	居中对齐	右对齐
活着	活着	活着
追忆似水年华	追忆似水年华	追忆似水年华

段落

在文本之间增加一个空行，即可创建一个新段落。

忽略MarkDown格式

在Markdown字符前加上反斜杠(\)，可以让编辑器忽略Markdown字符，并按照字符的字面含义解析之。