Markdown 笔记 - 基础使用入门指南 Typora、Joplin、Notion、obsidian、Atom、Bear

在互联网搜寻了很久，最终总结出适合自己的 Markdown 语法入门说明书，没有太多的复杂功能，建议：所见即所得，自己所有的总结需要根据自己的需求来，最终把它当做是说明书，我自己学习的时候也看得很杂，但是最终用得最多的还是基本、基础的语法，初学不清楚自己需要什么，要么看看是否有前人总结的基础、入门教程，要么把笔记做完整后再继续总结。公众号：人生只不过是一场投资

---

本人学习、整理的笔记个人YY为比较直观，用词刺眼，如有冒犯，多多见谅。

---

1. 标题

---

• Markdown 使用 # 来表示标题。标题有六个级别，一级标题使用一个 #，二级标题使用两个 #，依此类推。

  • 用法：使用 # 号 加 键盘空格键 （Space） 快捷输入。
  • 大纲标题是可以作为文章的目录，支持大纲标题作为目录的软件可以查看。

• 代码：

  # 一级标题
  ## 二级标题
  ### 三级标题
  #### 四级标题
  ##### 五级标题
  ###### 六级标题
  1
  2
  3
  4
  5
  6

• 注意：# 号前面不要留空格或者其他文字、符号，要在新的一行才有效果。

2. 段落

---

• 相较于对「字」的编辑，更高一层的就是对「段落」的编辑，和第一类字符稍有不同，这些字符会把一些段落变成特殊格式的段落。

  • 段落是通过一个或多个空行分隔的文本块。

    这是一个段落。
  
    这是另一个段落。
  1
  2
  3

3. 强调

---

• 文中可以使用星号 * 或下划线 _ 来表示强调（斜体）和加粗（粗体）。
  • 一个 * 或者 _ 是斜体；
  • 两个* 或者 _ 是粗体；
  • 三个* 或者 _ 是加粗斜体

3.1 斜体

*斜体* 或 _斜体_
1

• 效果展示：

  斜体 或 斜体

3.2 粗体

**粗体** 或 __粗体__
1

• 效果展示：

  粗体 或 粗体

3.3 加粗斜体

***加粗斜体*** 或 ___加粗斜体___
1

• 效果展示：

  加粗斜体 或 加粗斜体

4. 使用 HTML 格式化文字

---

• Markdown 支持嵌入 HTML 标签，这在需要一些 Markdown 不支持的高级格式时非常有用。

4.1 居中

<center>这是居中的文本</center>
1

• 效果展示：

  这是居中的文本

4.1 居中加粗

• 两个例子，用哪个都可以！

  <center>
      <strong>这是居中且加粗的文本</strong>
  </center>
  
  <center>
      <b>这是居中且加粗的文本</b>
  </center>
  1
  2
  3
  4
  5
  6
  7

• 效果展示：

  这是居中且加粗的文本 这是居中且加粗的文本

4.2 居中斜体

• 两个例子，用哪个都可以！

  <center>
      <em>文字斜体</em>
  </center>
  
  <center>
      <i>这是居中且斜体的文本</i>
  </center>
  1
  2
  3
  4
  5
  6
  7

• 效果展示：

  文字斜体 这是居中且斜体的文本

4.3 居中加粗斜体

• 两个例子，用哪个都可以！

  <center>
      <strong>
          	<em>这是居中、加粗且斜体的文本</em>
      </strong>
  </center>
  
  <center>
      <b>
          <i>这是居中、加粗且斜体的文本</i>
      </b>
  </center>
  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11

• 效果展示：

  这是居中、加粗且斜体的文本 这是居中、加粗且斜体的文本

• 注意：以上的 HTML 例子为了方便直观，我把代码分层和缩进，实际可以直接这样书写：

  <center><b><i>这是居中、加粗且斜体的文本</i></b></center>
  1

4.4 高亮

• markdow 语法的高亮，有些需要笔记软件开启设置后重启软件才可，例如：Typora

  ==Typora 的高亮==
  
  <mark>HTML 语法的高亮</mark>
  1
  2
  3

• 效果展示：

  Typora 的高亮

  HTML 语法的高亮

4.5 颜色

• 设置字体的颜色

  <span style="color:red">这是红色</span>
  <span style="color:blue">这是蓝色</span>
  <span style="color:green">这是绿色</span>
  <span style="color:yellow">这是黄色</span>
  
  1
  2
  3
  4
  5

• 效果展示：（展示不了，因为简书、CSDN 与笔记软件不同，代码修改如下）

  ' 这是简书、CSDN 在文中的原代码 '
  $\color{red}{红色字}$
  $\color{blue}{蓝色}$
  $\color{green}{绿色}$
  $\color{yellow}{黄色}$
  1
  2
  3
  4
  5

• 效果展示：

  $这是红色字$
  $这是蓝色$
  $这是绿色$
  $这是黄色$

5. 列表

---

• Markdown 支持有序列表和无序列表。

5.1 无序列表

• 使用星号 *、加号 + 或减号 - 表示无序列表。

  • 三个符号并没有区别，甚至可以混搭；建议取方便你的操作行为的符号进行输入。

  * 项目一
  * 项目二
    * 子项目二一
    * 子项目二二
  
  
  + 项目三
  
  - 项目四
  
  1
  2
  3
  4
  5
  6
  7
  8
  9
  10

• 在学习 Python 中，我习惯把 Python 的函数，或者方法、参数等列举之后写一个说明，也就是使用 列表 + 段落 的形式，本人习惯的例子：

  - 这是一个函数或者方法、参数：
    这是该函数或者方法、参数的说明。
  1
  2

  后面发现这个习惯不是很直观，所以使用表格的形式。

5.2 有序列表

• 使用 数字 和 英文的点 . 加 空格 表示有序列表。

  1. 项目一
  2. 项目二
     1. 没有2.1的格式
     2. 没有2.2的格式
        1. 没有2.1.1的格式
  
  3. 项目三
  
  1
  2
  3
  4
  5
  6
  7
  8

5.3 嵌套列表

• Markdown 允许在列表中嵌套其他列表，无论是有序列表还是无序列表。（组合格式）

  1. 第一项
     - 嵌套的无序列表项
       1. 嵌套的有序列表项
       2. 另一项
  2. 第二项
  
  1
  2
  3
  4
  5
  6

6. 链接

---

• Markdown 通过方括号 [ ] 包含链接文本，后跟圆括号 ( ) 包含URL 来创建链接。

  [点击这里访问百度](https://www.baidu.com )
  1

  注意：有些编辑器要求在圆括号 ( ) 里输入链接之后加一个空格，根据我的测试，很多不需要加空格的编辑器输入空格也是可以正常识别，所以，把空格当做一个习惯也是可以的。

6.1 带标题的链接

• 可以为链接添加一个可选的标题，在鼠标悬停时显示。

  [点击访问百度](https://www.baidu.com "百度主页")
  1

• 效果展示：

  点击访问百度

6.2 文章锚点

• 链接的高级用法，可以自定义文章标题锚点。

  • 为标题添加自定义锚点，方便通过点击链接的方式直接跳转到文档的特定部分。

• 注意：有些笔记软件需要先按住键盘的 Ctrl 再点击才能使用。（该功能个人测试比较通用，但不是所有的笔记软件都支持）

1. 在标题前添加锚点：在你想要添加锚点的标题前插入一个带有 id 属性的锚点标签。（# 号表示几级标题。）

   # <a id="title"></a> 1. 标题
   # <a id="paragraph"></a> 2. 段落
   1
   2

2. 在文中引用锚点：在文中的任何位置，你可以使用链接语法引用这个锚点。

   [点击跳转到第一章《标题》](#title)
   [点击跳转到第二章《段落》](#paragraph)
   1
   2

3. 效果展示：

   点击跳转到第一章《标题》
   点击跳转到第二章《段落》

4. 原理：

   • 在纯 Markdown 语法中，[跳转的标题](#我的标题) 的形式通常可能是无法直接实现跳转的，因为 Markdown 没有提供直接的方法来创建内部链接到标题。Markdown 的锚点链接通常是通过 HTML 的锚点标签来实现的。

   • Markdown 的超链接语法 [文本](URL) 通常用于创建外部链接，其中 URL 是指向外部资源的链接。在 Markdown 中，没有提供一种直接的方法来指向文档内的标题。

   • 如果要实现文档内的跳转，需要使用 HTML 锚点标签。所以在这种情况下，需要使用 HTML 标签来创建锚点，以实现跳转到文档中的标题。

7. 图片

---

• 插入图片的语法与链接相似，只需在最前面加一个感叹号 !。

  ![替代文字](https://www.example.com/image.jpg )
  1

  注意：有些编辑器要求在圆括号 ( ) 里输入链接之后加一个空格，根据我的测试，很多不需要加空格的编辑器输入空格也是可以正常识别，所以，把空格当做一个习惯也是可以的。

7.1 带标题的图片

• 同样可以为图片添加一个可选的标题。

  ![替代文字](https://www.example.com/image.jpg "图片标题")
  1

8. 视频

• 虽然 Markdown 本身不支持插入视频，但可以通过 HTML 标签实现。

• 参数说明：

  • width：宽度

  • height：高度。

  • src：视频的链接。

  • frameborder： iframe 的边框宽度。值为 0 表示没有边框。

    如果设置为 1 或其他正数，则会显示一个边框。

  • allowfullscreen：允许 iframe 中的内容（即视频）全屏显示。

    如果省略该属性，则视频可能无法全屏播放。

    该参数等价于：allow="fullscreen" 表示允许全屏显示。

    以下语法拿来即用，建议只改动 src 即可。

     <iframe width="560" height="315" src="xxx" frameborder="0" allowfullscreen></iframe>
    1

9. 引用

---

• 使用 > 表示引用。

  > 这是一个引用。
  > > 这是一个嵌套引用。
  1
  2

  引用这个东西，从你开始阅读本文就开始接触了，在每个效果展示前面的符号就是引用。

  多层引用时，每个引用的符号都要有一个空格。

10. 代码

---

10.1 行内代码

• 使用两个反引号 ` （英文输入法状态下，通常是侧键盘左侧上方的 Esc 下面，1 左边那个按键）包围行内代码。

  这是 `行内代码` 示例。
  1

10.2 代码块

• 使用三个反引号 包围多行代码，可以指定语言来高亮显示。(不是所有关键字都会，通常内置的就会)

  ```python
  def hello_world():
      print("Hello, world!")
  ```
  1
  2
  3
  4

11. 分隔线

---

• 华丽的分割线。

• 使用三个或更多的星号 *、减号 - 或下划线 _ 表示分隔线。

  ***
  ---
  ___
  
  1
  2
  3
  4

  分隔线这个东西，从你开始阅读本文就开始接触了，在每个标题下方，文字说明的上方就是分割线。

12. 表格

---

• 使用管道符 | 和破折号 - 创建表格。

  | 表头1 | 表头2 | 表头3 |
  | --- | --- | --- |
  | 内容1 | 内容2 | 内容3 |
  | 内容A | 内容B | 内容C |` 
  1
  2
  3
  4

12.1 对齐方式

• 可以使用冒号 : 指定表格内容的对齐方式。

  | 左对齐 | 居中对齐 | 右对齐 |
  | :----- | :------: | -----: |
  | 内容1  |  内容2   |   内容3 |
  | 内容A  |  内容B   |   内容C |
  1
  2
  3
  4

12.2 表格快捷创建

• 用 markdown 语法创建的表格比较复杂，但是我们可以先用 Excel 相关的软件创建一个表格，复制好表格之后在源代码模式粘贴我们的表格。（亲测软件：Typora ）

12.3 表格中的换行

• 在表格中使用代码块时，可以使用 HTML 的 <br> 或者 <br /> 来实现。(有些软件的快捷键是：shift + Enter)

  | 姓名   | 电话                   |
  | ------ | -------------------------- |
  | 张三 | 123<br>456 |
  | 李四 | 789<br />789 |
  | 王五 | 567567 |
  1
  2
  3
  4
  5

• 效果展示：

  姓名	电话
  张三	123123 456456
  李四	789 789
  王五	567567

12.4 表格中新增一行

• 在一个表格中，如果遇到需要向下新增一行的，可以试试这个操作：

  点击在指定的某一行，这某一行就是你要在下面新增的那一行，按键盘组合键：Ctrl + Enter 。

13. 任务列表

---

• 使用 - 加 空格 加 方括号 [ ] （括号里面是空格）表示未完成任务， - 加 空格 加 [x] 表示已完成任务。

  • 未完成的任务，在非源代码编辑模式下，可以直接点击完成。

  - [x] 完成任务一
  - [ ] 未完成任务二
  - [ ] 未完成任务三
  1
  2
  3

• 效果展示：

  • 完成任务一
  • 未完成任务二
  • 未完成任务三

14. 转义字符

---

使用反斜杠 \ 转义特殊字符。

\*这是星号，不是斜体\*
1

Markdown 语法使用建议

列表、引用、代码块（包括 HTML 格式化文字，不含行内代码） 这三种语法属于 Markdown 的区块语法，在使用 Markdown 笔记软件的源代码编辑模式的时候，建议在开始之前和结束之后空一行，避免编辑器渲染的时候误解导致预览模式显示错误。