Markdown学习笔记(更新)

简介

目标

轻量级的标记型语言，兼容 HTML， 易读易写
语法的目标是：成为一种适用于网络的书写语言
格式语法在HTML区块标签内无效，而在HTML区段标签内有效
自动转换，不须特殊处理 < 与 &
工具：Atom、Marp、VSCode、Typora

本文章将原来的文章的内容用Markdown编辑器重新编辑美化了一下。在原文章中，我使用了Markdown的语法，但因为它是在CSDN的富文本编辑器中编辑的，也就没能展示出它应有的效果。有兴趣的话可以跳过去看看原文章。地址：
https://blog.csdn.net/qq_29695701/article/details/79694220

---

一、区块元素

1. 段落和换行
2. 标题
3. 区块引用
4. 列表
5. 代码区块
6. 分隔线

1. 段落和换行

段落由一个或多个连续的文本行组成，它的前后要有一个以上的空行。
普通段落不该用空格或制表符来缩进。

注：插入<br/>强制换行，但仍旧属于同一段落。有些支持回车，有些则不支持

2. 标题

• 类 Setext：利用= 与 - ，至少两个。

示例：
类 Setext
------
显示为：

类 Setext

• 类 Atx 形式：行首（必须）插入 1 到 6 个 # ，标题文字前加空格，闭合后更美观

示例：
## 这是 H2
## 这是 H2 ##
显示为：

这是 H2

这是 H2

3. 区块引用

使用 > ，可以嵌套。
引用的区块内可以使用其他的 Markdown 语法。

第一层

第二层

4. 列表

• 无序列表
  标记： * 、+ 、- 加空格。可混用，非第一项可以使用有序列表标记

• 有序列表
  标记：第一项必须数字 + 英文句点，可无序，非第一项可使用 *、+、-

一般情况下，列表标记最多可缩进3个空格，标记后面必须至少一个空格或制表符；
列表内部可嵌套，但属于子项的标记符号应相对于其父标记缩进；
项目内可使用 段落 和 区块引用，留心项目间的空行。

5. 代码区块

• 方法一：
  缩进 4 个 空格 或是 1 个 制表符。
  前面必须空一行，并且在代码区块中，Markdown 语法不会被转换。
• 方法二：
  块前块后使用三个连续的 “ ` ” 包裹起来。

6. 分隔线

一行中使用三个以上的 * 、- 、_ 来建立一个分隔线。

行内可有空格，建议使用下划线

---

二、区段元素

1. 链接
2. 强调
3. 代码
4. 图片

1. 链接

行内式 的链接：[Key](LinkPath "Option Title")
参考式 的链接：[Key][id] (另起它行) id：[id]: LinkPath "Option Title"
隐式链接 ：省去id，直接定义Key
id不区分大小写，位置任意；Title不限于使用双引号，还可以单引、括号
链接网址可以用 <> 限定

2. 强调

使用 * 或 _，下划线更易读。

示例：
斜体强调: _被强调的文字_
粗体强调：__被强调的文字__
粗体加斜体强调：___被强调的文字___

注：Marp不支持下划线

3. 代码

标记一小段行内代码 ：用一对反引号 ` 包起来
在代码区段内插入反引号：多个反引号来开启和结束代码区段
代码段中插入个单引号的方式：`` ` ``
码区段内的 & 和 < 都会被自动地转成 HTML 实体

4. 图片

与链接方式相似，但要在非定义的 [Key] 前加!
不同的是，Key不会被显示，但Title会被显示
只能插入图片，但不能设置宽度

---

其它

• 自动链接：只要是用 <> 包起来， Markdown 就会自动把它转成链接。
• 反斜杠\：转义

相关链接：

• https://github.com/tomeasure/Markdown-Learning-Note/
• https://www.appinn.com/markdown/
• http://www.markdown.cn/
• https://www.jianshu.com/p/e063303317cb/
• http://tinylab.org/use-markdown-to-write-slides/
• https://github.com/yhatt/marp/releases/

---