Markdown学习笔记

Markdown学习笔记

这份笔记是记录我学习Markdown的知识，理解以及运用等。

将分几个章节分别描述Markdown的应用。

基础语法

标题

在Markdown语法中，标题支持使用两种标记：底线(-/=) 和 # 。

1.使用底线的语法如下

标题内容

=========

或

标题内容

---------

语法说明如下。

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

2.使用 # 的语法如下。

# + 空格 +标题内容

语法说明如下。

1）在行首插入#可标记出标题。
2）#的个数表示了标题的等级。
3）建议在#后加一个空格。
4）Markdown中最多只支持六级标题。

使用规范。
建议使用 # 标记标题，而不是 === 或 - ，因为后者会难以阅读和维护。

---

##粗体和斜体

在Markdown中，粗体由两个星号或两个下划线包裹，斜体由一个星号或一个下划线包裹。

• 粗体格式的语法如下。

  **加粗内容**

  或

  __加粗内容__

• 斜体格式的语法如下。

  *斜体内容*

  或

  _斜体内容_

• 使用规范。
  建议粗体使用两个星号包裹，斜体使用一个星号包裹，因为星号比较常见，而且比下划线可读性更强。

---

段落与换行

Markdown中的段落由一行或多行文本组成，不同的段落之间使用空行来标记。

+语法说明如下。

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

• 使用规范
  为了便于阅读，应该限制每行字符的数量，通常每行不超过80个字符，可以在编辑器中进行设置。

---

列表

有序列表和无序列表

在Markdown中支持使用有序列表和无序列表，有序列表用数字序号 + 英文句号 + 空格 +列表内容来标记，无序列表由 * / + / - 加 空格 +列表内容来标记。

• 有序列表的语法如下。

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

• 无序列表的语法如下。

*/ + / - +空格 + 列表内容

小提示：使用 * / + / - 来标记无序列表的效果是相同的。

嵌套列表

• 嵌套列表的语法实例如下。

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

• 语法属下
  1）列表中可以嵌套列表。
  2）有序列表和无序列表也可以相互嵌套。

• 使用规范。
  建议使用 - 来标记无序列表，因为 * 容易跟粗体和斜体混淆，而 + 不流行。因此，推荐：

- 吃
- 喝

如果列表项有换行，建议给无序列表使用3个空格，给有序列表使用2个空格。
如果一个列表中的每个列表项都只有1行，建议列表项之间不要有空行。
如果列表项中有换行，建议在列表项之间空1行，这样会比较容易区分多行列表的开始和结束。

数字、字符、序号列表是用英文半角句号，句号后加空格。

---

分割线

在Markdown中，分割线由三个以上的星号、减号或者下划线来标记。

要求：分割线必须使用至少三个以上的星号、减号或者下划线。
行内不能有其他的字符。
可以在标记符中间加上空格。

---

图片

• 插入图片的语法如下。

![图片名字](图片地址)

说明：
1）图片名字在图片无法正常显示时会比较有用，正常情况下可以为空。
2）图片地址可以是本地图片的路径也可以是网络图片的地址。
）本地图片支持相对路径和绝对路径两种方式。

---

链接

• 文字链接
  文字链接就是把链接地址直接写在文本中。语法是用方括号包裹链接文字，后面紧跟着括号包裹的链接地址。
  [链接名字](链接地址)

但是这种方式在链接多了的情况下可读性会变差。可以使用定义的方法。
把链接的地址在某个地方统一定义好，然后在正文中通过“变量”来引用，可读性会变强。

建议把链接地址作为“变量”，先在Markdown文件的页尾定义好。

• 网址链接
  在Markdown中，将网络地址或邮箱地址使用<>包裹起来会被自动转换为超链接。

---

行代码块与代码块

行代码块使用ESC下的飘号进行包裹。nihao代码块则以Tab按键或四个空格开头。
如果代码超过一行，那么就是用围栏代码块吧。围栏代码块是扩展语法，并显示的声明语言，并且可以显示语法高亮。

你好，许先生。我们很荣幸的邀请您参见我们的宴会。
地点：上海市普陀区静安路101号
时间：2021年1月21日上午九点
	期待您的光临

在代码块与行代码中如果想要换行的话，按回车后切换到下一行记得再按一次TAB。这尼玛书上也没说。破书。还是我自己试出来的。

##缩进
缩进的关键子为&emsp加一个英文状态下的分号。

  我来晚了，不曾迎接远客。

引用

引用由>加引用内容来标记。
多行引用可以在每一行的开头都插入>。
在引用中可以嵌套使用。
在引用中可以使用其他的Markdown语法。
段落与换行的格式在引用中也是适用的。

使用规范：引号后加空格。并且建议每一行的引用都是用符号>。不要再引用中添加空行。

转义

当我们想插入一些标记符号，但又不想让这些符号被渲染时，可以使用 \ 进行转义。
\特殊符号

##扩展语法GFM

Git Hub Flavored Markdown（简称GFM）提供了包括但不限于表格、任务列表、删除线、围栏代码、Emoji等在内的标记语法。

删除线

被两个波浪线包裹的文字会添加删除线。

~~被删除的文字~~

表情包

使用表情包代码即可。

表格

如果想用markdown记录表格，建议在使用excel弄好。以图片格式弄进来。比markdown本身的语法要好用一些。因为主要是用来记录笔记的。表格可能不是使用的要求的那么严格。

任务列表

-[ ] 未勾选
-[X] 已勾选

##围栏代码快

围栏代码快使用三个飘号包裹。或者三个波浪线包裹。

锚点

锚点，也称为书签，用来标记文档的特定位置，使用锚点可以跳转到当前文档或其他文档中指定的标记位置。
Markdown会被渲染成HTML页面，在HTML页面中可以通过锚点实现跳转；GitHub、GitBook项目文档中的目录也是通过锚点实现跳转的。

• 锚点的语法如下。

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

• 语法说明如下。
  1）锚点名建议使用字母和数字，当然中文也是被支持的，但不排除有些网站支持得不够好。
  2）锚点名是区分英文大小写的。
  3）在锚点名中不能含有空格，也不能含有特殊字符。

文档的特定位置，使用锚点可以跳转到当前文档或其他文档中指定的标记位置。
Markdown会被渲染成HTML页面，在HTML页面中可以通过锚点实现跳转；GitHub、GitBook项目文档中的目录也是通过锚点实现跳转的。

• 锚点的语法如下。

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

• 语法说明如下。
  1）锚点名建议使用字母和数字，当然中文也是被支持的，但不排除有些网站支持得不够好。
  2）锚点名是区分英文大小写的。
  3）在锚点名中不能含有空格，也不能含有特殊字符。