Markdown个人学习记录

Markdown个人学习记录

参考书籍：《了不起的Markdown》-毕小朋-电子工业出版社

第一章 Markdown概述

• Markdown作为现在最流行的轻量级“写作语言”，具有更加易读、易写的特点。
• 起初的Markdown仅用于网络写作，但本身功能有限，无法满足所有的需求和场景，由此产生了许多的扩展语法，现在最流行的扩展语法是Github Flavored Markdown，简称GFM。
• Pandoc可以将Markdown文件转化为各种各样的文件格式，如HTML、OpenDocument等。
• Markdown适用场景：对排版无特殊要求，并且不想花太多时间再排版上，如果对排版要求较高，仍然建议适用Word，也可以将Markdown转化为Word，随后进行个性化的排版。
• Markdown通过编辑器进行文章的渲染、发布或导出，常用的编辑器如Typora、VS Code、GitBook以及印象笔记。
• 语法学习
  • 基础语法
  • 扩展语法
  • 写作规范¹

第二章 Markdown语法

第一节 基础语法

1. 字体

1.1 标题

• 标题支持适用底线（-/=）和#两种标记，但由于底线（-/=）和后续的语法会出现重合，因此建议使用**#**。
• 使用语法：#+空格+标题内容

# 一级标题
## 二级标题
###三级标题
#### 四级标题
##### 五级标题
##### 六级标题

• 语法说明：
  • #的个数表示标题的等级
  • 建议在#后加一个空格
  • Markdown最多支持前六级标题
• 使用规范：
  • 标题的前后都要空一行，除非标题在文档开头，另外#与标题文本之间也要有一个空格。
  • 标题结尾不要有空格、标点符号
  • 标题尽量简短

# 文档标题

参考资料

摘要

目录

## 第一章 XXXX

### 第一节 XXXX

#### 一、XXXX

##### （一）XXXX

###### 1. xxxx

### 第二节 xxxx

## 第二章 

• 文档结构说明
  1. 文档的第一个标题应该是一级标题，写在第一行，建议与文件名相同
  2. 参考资料、摘要、目录等模块根据个人需要自行修改
  3. 正文内容，正文从二级目录开始，逐级增加，不可跳级，不可相同
     1. 个人喜欢对标题进行添加序号，也可根据自己需要自行选择，不加序号也可
     2. 对于层级较多的，用第X章、第X节、一、（一）、1. 、1.1逐级递减，如果层级交少，直接选择序号从一开始

1.2 段落与换行

• 段落由一行或多行文本组成，不同的段落之间用空行来标记
• 语法说明：
  1. 如果行与行之间没有空行，则会被视为同一段落
  2. 如果行与行之间有空行，则会被视为不同段落
  3. 空行是指行内什么都没有，或者只有空格和制表符
  4. 如果想在段内换行，则需要在上一行的结尾插入两个以上的空格然后回车
• 使用规范
  • 为便于阅读，应该限制每行字符的数量，通常每行不超过80个字符，可以在编辑器中进行设置
  • 关于换行，建议如下：
    • 当超过80个字符后进行换行
    • 在一句话结束（。或！或？）之后换行
    • 当URL较长时换行²

1.2.1 列表

• 有序列表
  • 语法：数字序号 + 英文句号 + 空格 + 列表内容
  • 范例：1. xx
• 无序列表
  • 语法：*/+/- + 空格 + 列表内容，但是建议使用-
  • 范例：- xxxx
• 嵌套列表
  • 有序列表和无序列表可以相互嵌套
  • 用TAB嵌入下级
• 使用规范
  • 建议使用-来标记无序列表，因为*容易跟粗体和斜体混淆，而+不流行
  • 如果一个列表中所有的列表项都没有换行，建议使用1个空格
  • 如果列表项有换行，则建议给无序列表使用3个空格，给有序列表使用2个空格
  • 如果每个列表中的每个列表项都只有1行，建议列表项之间不要有空行
  • 如果列表项中有换行，建议在列表项之间空1行，这样会比较容易区分多行列表项的开始和结束
  • 数字、字符、符号列表使用英文半角句号，句号后加空格

列表项内没有换行，则建议使用1个空格

- 秋（1个列表项）
- 围
- 软

如果列表项有换行，则建议给无序列表使用3个空格，给有序列表使用2个空格

-   这个列表项（3个空格）
有换行（一个列表项内部有换行）
 
-   这个没有
 
1.  这个有序列表（两个空格）
有换行
 
2.  这个没有-   这个列表项（3个空格）
有换行（一个列表项内部有换行）
 
-   这个没有
 
1.  这个有序列表（两个空格）
有换行

2.  这个没有

如果每个列表中的每个列表项都只有1行&#