《了不起的 markdown》阅读记录

《了不起的 Markdown》阅读记录

刚看到这本书的时候，我总是在想，Markdown 那么简洁的语法规则，是怎么水成一本书的……

《了不起的 Markdown》里，对于 Markdown 语法只占书的五分之一左右，剩下的主要是对工具、及其使用技巧，还有创建自己的个人博客的详尽描述。这里仅记录语法和一些插件的使用技巧，想系统学习的，推荐这本书或者 Markdown 菜鸟教程

为什么选择 Markdown

• 更专注于文字
• 简洁的排版
• 兼容性好

Vscode 与 Markdown

这里呢首先介绍一些 VScode 里比较好用的 Markdown 插件，以便在接下来的语法部分更便捷地叙述。

• Markdown All in One

  • 快捷键
  • 自动生成并更新目录
  • 自动格式化表格
  • LaTeX 数学公式支持
  • 将 Markdown 打印为 HTML（命令 Markdown: Print current document to HTML）
  • 选中文字，粘贴链接时自动转化为文字链接

• Markdown Preview Enhanced

  • 目录
  • 批注
  • 合并单元格
  • 插入 LaTeX 公式
  • 用纯文本绘图
  • 运行代码
  • 导入和导出制作幻灯片
  • 高亮文本（仅在 Markdown Preview Enhanced 预览可见）

• Pangu-Markdown

  • 在英文字母和中文之间添加空格（强迫症必备）

Markdown 基础语法

最难的不是语法，而是开始使用
——《了不起的 Markdown》

字体

标题

标题	格式
一级标题	#+空格+一级标题
二级标题	##+空格+二级标题
……	……

最多六级标题

一般格式：

# 文档标题
作者
摘要
目录
## 标题 1
### 标题 1.1

粗体和斜体

• 粗体：**加粗文本**
  快捷键：Ctr+B
• 斜体：*斜体文本*
  快捷键：Ctr+I

段落与换行

• 行与行之间没有空行（一行中只有制表符和空格），就会被视为同一段落。

• 上一行的结尾插入两个以上的空格键然后回车，即可实现段内换行

列表

• 有序列表
  数字+.+空格+内容

• 无序列表
  - + 空格 + 内容

• 嵌套列表
  - + 空格 + 内容
  Tab+ - + 空格 + 内容

• 有序和无序列表间也可以相互嵌套

分割线

三个以上的*或-

插入图片


• 图片描述一般为空
• 图片地址可以是本地图片地址也可以是网络图片地址
• 本地图片地址使用的是相对路径

链接

[文字](链接)

行内代码与代码块

• 行内代码
  `代码`
• 代码块
  ```
  代码块
  ```

引用

>+空格+引用内容

• 允许多层嵌套
• 建议引用中的每一行开头都使用>

拓展语法 GFM

• 删除线
  ~~被删除线的内容~~

• 表情符号
  仅在 Markdown Preview Enhanced 的预览窗口可见

• 表格

| 名字 | 年龄 |
| :—: | :—: |
| 小明 | 12 |

• 锚点
  [1](#+标题名)
  标题名在 vscode 中只对数字和英文有较好的支持

排版小技巧

• 加空格

  • 中英文之间加空格
  • 英文标点符号之后
  • >前后加空格

• 正确的英文大小写

  • macOS
  • iPhone
  • iPad Pro
  • MacBook Pro
  • iOS
  • GitHub

• 标题前后空一行

• 在中英文之间添加空格

其他注意事项

Markdown 特殊符号的书写

在 Markdown 中经常有一些特殊意义的字符

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

需要使用\符号进行转义。

相关链接

• 在 VSCode 下用 Markdown Preview Enhanced 愉快地写文档
• Markdown Preview Enhanced
• Markdown 与 VS Code 官方文档
• Markdown All in One
• Pangu-Markdown