Markdown 教程
什么是Markdown
Markdown 是一种轻量级标记语言。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。
简而言之,就是通过一些符号标记来标记文本的样式。
语法部分
下面将会展示markdown的常用语法。
标题
Markdown 语法:
1 | # 第一级标题 `<h1>` |
效果如下:
第一级标题 <h1>
第二级标题 <h2>
第六级标题 <h6>
强调
Markdown 语法:
1 | *这些文字会生成`<em>`* |
效果如下:
这些文字会生成<em>
这些文字会生成<u>
这些文字会生成<strong>
这些文字会生成<strong>
换行
根据不同的markdown解释器有不同的方法。一般为四个及以上的空格加回车
列表
无序列表
Markdown 语法:
1 | * 项目一 无序列表 `* + 空格键` |
效果如下:
- 项目一 无序列表
* + 空格键
- 项目二
- 项目二的子项目一 无序列表
TAB + * + 空格键
- 项目二的子项目二
- 项目二的子项目一 无序列表
有序列表
Markdown 语法:
1 | 1. 项目一 有序列表 `数字 + . + 空格键` |
效果如下:
- 项目一 有序列表
数字 + . + 空格键
- 项目二
- 项目三
- 项目三的子项目一 有序列表
TAB + 数字 + . + 空格键
- 项目三的子项目二
- 项目三的子项目一 有序列表
任务列表(Task lists)
Markdown 语法:
1 | - [ ] 任务一 未做任务 `- + 空格 + [ ]` |
效果如下:
- 任务一 未做任务
- + 空格 + [ ]
- 任务二 已做任务
- + 空格 + [x]
图片
Markdown 语法:
1 |  |
效果如下:
链接
Markdown 语法:
1 | email <example@example.com> |
效果如下:
Email 连接: example@example.com
连接标题Github网站
自动生成连接像: http://www.github.com/ 这样
区块引用
Markdown 语法:
1 | 某某说: |
效果如下:
某某说:
第一行引用
第二行引用文字
行内代码
Markdown 语法:
1 | 像这样即可:`<addr>` `code` |
效果如下:
像这样即可:<addr>
code
多行或者一段代码
Markdown 语法:
开头结尾添加三个 `
效果如下:
1
2
3
4
5
6
7
8
9
using namespace std;
int main() {
cout << "Welcome to my blog!" << endl;
return 0;
}
表格
Markdown 语法:
1 | | Tables | Are | Cool | |
效果如下:
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
删除线
Markdown 语法:
加删除线像这样用: ~~删除这些~~
效果如下:
加删除线像这样用: 删除这些
分隔线
以下三种方式都可以生成分隔线:
***
*****
- - -
效果如下:
脚注(Footnote)
Markdown 语法:
1 | 这是一个脚注:[^sample_footnote] |
效果如下:
这是一个脚注:^sample_footnote
TOC
Markdown 语法:
1 | [TOC] |
效果如下:
[TOC]
/