第一部分：markdown

第一部分：markdown

markdown只适用于排版要求不高的场景，如果对排版要求比较高的话，那就要使用专业的排版工具了。

markdown的使用

1、基础语法

1.1、标题

标题支持使用两种标记：底线（-或者=）和#号。

使用底线的语法如下：

标题内容
------
或者
标题内容
======

语法说明：

1. 底线=表示一级标题
2. 底线-表示二级标题
3. 底线符号的数量至少2个
4. 这种语法只支持两级标题

使用#的语法如下：

#+空格+标题内容

语法说明：

1. #的数量表示了标题的等级
2. 最多支持前六级标题

1.2、粗体和斜体

粗体由两个*或者_包裹。斜体由一个 *或者一个 _包裹。

粗体格式的语法：

**加粗内容**
或者
__加粗内容__

斜体格式的语法：

*斜体内容*
或者
_斜体内容_

1.3、段落与换行

语法说明如下：

1. 如果行与行之间没有空行，则会被视为同一段落
2. 行之间有空行，被视为不同段落
3. 空行是指行内什么都没有，或者只有空格以及制表符
4. 如果想要换行，需要在上一行的结尾插入两个以上的空格然后按回车建

1.4、列表

有序列表：

数字序号+英文句号+空格+列表内容

无序列表：

*或者+或者-+空格+列表内容

注意：使用*或者+或者-来标记无序列表的效果是相同的。

嵌套列表：

第一层列表
TAB+第二层列表
TAB+TAB+第三层列表

语法说明：

1. 列表中是可以嵌套列表的
2. 有序列表和无序列表也是可以互相嵌套的

1.5、分割线

分割线使用语法如下：

***
或者
---
或者
___

语法说明：

1. 分割线需要至少三个以上的*或者-或者_来标记
2. 行内不能有其他字符

1.6、图片

插入图片的语法如下：

！[图片替代文字](图片地址)

语法说明：

1. 图片代替文字在图片无法正常正常显示时比较有用，正常情况下可以为空
2. 图片的地址可以是本地图片的路径也可以是网络图片的地址
3. 本地图片支持相对路径和绝对路径两种

1.7、链接

文字链接：

语法如下：

[链接文字](链接地址)

引用链接：就是把链接地址作为“变量”，先在markdown文件的页尾定义好，然后在正文中引用。

语法如下：

引用链接：[链接文字][链接标记]
底部：[链接标记]:链接地址

语法说明：

1. 链接标记可以有数字、字母、空格和标点符号
2. 链接标记不区分大小写
3. 定义的链接内容可以放在文件的任意位置，但是建议放在页尾
4. 当链接地址为网络地址时要以http/https开头，否则会被识别为本地地址

网络链接：

将网络地址或者邮箱地址给包裹起来，会被自动转换为超链接。

语法如下：

<URL或者是邮箱地址>

1.9、行内代码与代码块

行内代码：

语法如下：

`代码`

代码块：

语法如下：

以Tab键开头或者4个空格开头

1.10、引用

语法：

>引用内容

语法说明：

1. 多行引用也可以在每一行的开头都插入>
2. 在引用中可以嵌套引用
3. 在引用中可以使用其他的markdown语法
4. 段落与换行的格式在引用中也是适用的

1.11、转义

如果想插入一些标记符号，但又不想让这些符号被渲染时，可以使用\进行转义

语法如下：

\特殊符号

可被转义的特殊符号如下：

\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号

2、扩展语法

2.1、删除线

语法如下：

~~被删除的文字~~

2.2、表情符号

:表情代码:

例如：

:smile:
:laughing:
:+1:
:-1:
:clap:

关于更多的表情符号，请自行查阅。

2.3、自动链接

语法：扩展语法可以不用使用<>来包裹链接地址，会自动识别链接。

以www或者http://开头的URL地址

注意：自动链接只识别www或者http://开头的URL地址

2.4、表格

表格的语法如下：

|表头1|表头2|表头3|
|----|-----|-----|
|内容1|内容2|内容3|

语法说明：

1. 单元格使用|来分隔，为了阅读清晰，建议最前和最后都使用|
2. 单元格和|之间的空格会被移除
3. 表头与其他行使用-----来分隔
4. 表格对齐格式如下：
   • 左对齐（默认）：:----
   • 右对齐：-----:
   • 居中对齐：:-------:
5. 块级元素（代码区块、引用区块）不能插入表格中

2.5、任务列表

语法如下：

- [ ] 未勾选
- [x] 已勾选

语法说明：

1. 任务列表以-+空格开头，由[+空格或者x+]组成
2. x可以小写，也可以大写，推荐使用小写
3. 当方括号中的字符为空格时，复选框是未选中状态，为x时是选中状态

2.6、围栏代码块

语法如下：

使用3个连续的`包裹
或者
使用3个连续~包裹

2.8、锚点

也称为书签，用来标记文档的特定位置，有跳转的功能。

语法如下：

[锚点描述](#锚点名)

语法说明：

1. 锚点名建议使用字母和数字，当然中文也是被支持的
2. 锚点名是区分英文大小写的
3. 在锚点名中不能含有空格。也不能含有特殊字符。

3、一些建议

3.1、加空格

1. 英文标点符号与后面的字符之间需要加上空格，与前面的字符之间不需要加空格。
2. 当在中文、英文中使用>（半角）标识路径时，两边都要加空格

3.2、不加空格

1. 中文标点符号和数字、中文、英文之间不需要添加空格
2. 数字和百分号之间不需要加空格
3. 数字和单位符号之间不需要加空格
4. 英文和数字组合成的名字之间不需要加空格
5. 当/（半角）表示“或”、“路径”时，与前后的字符之间不加空格
6. 货币符号后不加空格
7. 负号后不加空格

3.3、半角和全角

全角：中文标点符号是全角，占两个字节

半角：英文标点符号和数字是半角，占一个字节

1. 在中文排版中使用全角的标点符号
2. 在英文中使用半角的标点符号

最后，想要了解更多关于markdown的知识，请自行去官网查阅。

3.4、关于可能会遇到的一些问题

很多支持markdown的软件都对我们上面讲的语法做了一些规范，甚至还有的做了一些微小的改动以及一些扩展的新语法，另外还可以使用快捷键来使用上面的语法。

有些编译器还会对我们写的一些文章进行自动的修饰润色，这也很正常。

如果在使用中发现上面的一些语法在具体使用时会有些差异，很正常。不同的编译器或多或少有些差异。

下一部分会讲一下支持 markdown 语法的 Typora 这个软件的使用。