MarkDown 使用手册
MarkDown 使用手册
MarkDown 是一款用来写作的轻量级语言,对我个人来说,它没有 Word 的排版复杂,也没有 Text 的简陋。如果你用过 Jupyter Notebook ,你就会发现它的简洁之美。在美观和简单之间,这个度 MarkDown 掌握的刚刚好。你可以将更多的精力放在作品的内容之中,尤其对于程序员来说,我觉得极其友好。MarkDown 的使用还是需要一定的学习成本的,所以在这里写份手册用来防蠢。
编辑器:Typora
我现在使用的是 Typora,其他的我也没怎么用,主要是我是从 Jupyter Notebook 中知道 MarkDown 的,对于 Jupyter Notebook 的即时渲染挺喜欢的,所以对于其他将源码编辑和效果预览分为两部分的编辑器并不感冒。当然 Typora 并不是完美的,对于Typora 的使用方法我会再写一份使用手册,这里就不详述了。
一、标题及目录
1. 一至六级标题
标准语法:#
+ "空格" + 文字
一个 # 是一级标题,两个 # 是二级标题,以此类推,共支持六级标签。
示例:
# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题
2. 显示目录
标准语法:直接将 [toc] 放在要显示位置的首位。
示例:
[toc]
二、字体
1. 加粗:
标准语法:左右两边分别用 **
包起来。(两个 * 号)
示例:
**加粗**
加粗
2. 斜体:
标准语法:左右两边分别用 *
包起来。(一个 * 号)
示例:
*斜体*
斜体
4. 斜体加粗:
标准语法:左右两边分别用 ***
包起来。(三个 * 号)
示例:
***斜体加粗***
斜体加粗
5. 删除线:
标准语法:左右两边分别用 ~~
包起来。(两个 ~ 号)
示例:
~~删除线~~
删除线
三、插入
1. 单行代码:
标准语法:左右两边分别用 ` 包起来。(键盘右上角,英文名称:accent,重音符,用来表示字母的特别音质而在印刷体或书写体中使用的符号)。
示例:
`printf("Hello MarkDown!!!\n");`
printf("Hello MarkDown!!!\n");
2. 多行代码:
标准语法:上下两端分别用 ``` 包起来。(三个重音符)。
示例:
``` int a=1; int b=2; printf("%d\n", a+b); ```
int a=1; int b=2; printf("%d\n", a+b);
3. 分割线
标准语法:三个或三个以上的 -
、_
或 *
:
示例:
---
___
***
4. 图片
标准语法:
图片标题可不写,写了之后的功能就是,当鼠标移到图片上时显示内容。
当然,一般情况下,复制粘贴也是支持的。
示例:

5. 超链接
标准语法:[超链接名](超链接地址 "超链接title")
title 可加可不加,但必须加 http/https。
如果需要在 Typora 中打开链接,需要按着 Ctrl 再点击链接。
示例:
[我的博客](https://Wise-Bug.github.io)
四、序列和表格
1. 无序序列
标准语法:*
、+
或 -
+ "空格" + 内容
在序列前加 Tab 可生成一个子序列。
示例:
* 序列1 * 子序列1 * 子序列2 * 序列2
- 序列1
- 子序列1
- 子序列2
- 序列2
2. 有序序列
标准语法:数字 + .
+ "空格" + 内容
在序列前加 Tab 可生成一个子序列。
示例:
1. 有序序列1 1.1 有序子序列1 1.2 有序子序列2 2. 有序序列2 * 无序子序列1 * 无序子序列2
- 有序序列1
1.1 有序子序列1
1.2 有序子序列2 - 有序序列2
- 无序子序列1
- 无序子序列2
3. 表格
标准语法:
- 表头:|表头1|表头2|表头3|
- 分割表头和内容:|----|----|----| ,这部分还有一个功能就是自定义居中、居左、居右。
- 默认居左
- 居中:|:----:|:----:|:----:|
- 居右:|----:|----:|----:|
- 内容:|内容1|内容2|内容3|
但是由于 Typora 这个编辑器过于自动化,基本上只要写了表头之后,就会自动生成表格了,如果需要自定义修改,需要启用源代码模式进行修改。还有一点,一般不会进行表头的编写,这样可以自定义内容的格式,可变幻的风格会更大。
示例:
| 表头1 | 表头2 | 表头2 | | ----- | :-----: | -----: | | 内容1 | 内容2 | 内容3 |
表头1 | 表头2 | 表头2 |
---|---|---|
内容1 | 内容2 | 内容3 |
五、其他
其实,以上部分已经可以处理绝大部分的文档编写了。但是 MarkDown 的功能绝不只有这些,下面的部分作为扩展部分。