Markdown学习笔记

教程地址：Markdown教程 | 菜鸟教程

Markdown 介绍

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。

Markdown 语言在 2004 由约翰·格鲁伯（英语：John Gruber）创建。

Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。

Markdown 编写的文档后缀为 .md, .markdown

Markdown 标题

使用 # 号可表示 1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。使用 = 和 - 标记一级和二级标题

一级标题 # 一级标题

二级标题 ## 二级标题

三级标题 ### 三级标题

.....

六级标题 ###### 六级标题

---

这里是一级标题

这里是一级标题
============

这里是二级标题

这里是二级标题
-------------

Markdown 段落

• 关于换行

  • Markdown 段落的换行是使用两个以上空格加上回车。
  • 也可在段落后面使用一个空行来表示重新开始一个段落。

• 字体

  斜体 斜体 *斜体* _斜体_
  粗体 粗体 **粗体** __粗体__
  粗斜体 粗斜体 ***粗斜体*** ___粗斜体___

• 分割线

  用三个以上的星号、减号、底线来建立一个分隔线，可以在星号或是减号中间插入空格，行内不能有其他东西。

  *** * * * --- - - - ___ _ _ _

  ---

• 下划线

  下划线可以通过 下划线来实现，
  emmmmm. 下划线在这里好像显示有问题？

• 删除线

  删除线可以通过 ~~删除线~~来实现

• 脚注^[1]

  创建脚注格式类似这样 [^脚注]
[^脚注]: 123

Markdown 列表^[2]

• 无序列表

  无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记：
  • 第一项
  • 第二项
  • 第三项

• 有序列表

  有序列表使用数字并加上 . 号来表示，如：
  1. 第一项
  2. 第二项
  3. 第三项

• 列表嵌套

  1. 第一项
     • 第一项无序1
     • 第一项无序2
  2. 第二项
     • 第二项无序1
  3. 第三项
  4. 第四项

Markdown 区块

通过"> "来使用区块，同时可以和其他符号嵌套使用

• 第一项

  菜鸟教程
  学的不仅是技术更是梦想

• 第二项
• 第三项

Markdown 代码

如果是段落上的一个函数或片段的代码可以用反引号把它包起来（`），例如：printf() 函数

• 代码区块

  代码区块使用 4 个空格或者一个制表符（Tab 键）。
  你也可以用 ``` 包裹一段代码，并指定一种语言（也可以不指定）：
  如Java：
  ```java
  java代码
  ```
  Java版本：

  public class HelloWorld {
      System.out.println("Hello World!");
  }
  

  Python版本：

  import os
  
  print("runoob")
  

  Javascript版本：

  $(document).ready(function () {
    alert('RUNOOB');
  });
  

Markdown 链接

这是一个链接 菜鸟教程 这是一个链接 [菜鸟教程](https://www.runoob.com)
https://www.runoob.com

链接也可以用变量来代替，文档末尾附带变量地址：
这个链接用 runoob 作为网址变量 [Runoob][runoob]
然后在文档的结尾为变量赋值（网址）
[runoob]: http://www.runoob.com/

Markdown 图片

• 格式说明

  ![alt 属性文本](图片地址)
  ![alt 属性文本](图片地址 "可选标题")
  ![图片描述](图片地址)
  ![图片描述](图片地址 "可选标题")
  

  • 开头一个感叹号 !
  • 接着一个方括号，里面放上图片的替代文字
  • 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 'title' 属性的文字

• 图片使用实例

  测试图片
• 注：Markdown 还没有办法指定图片的高度与宽度，如果你需要的话，你可以使用普通的 标签。

Markdown 表格

• 格式说明

  |  表头   | 表头  |
  |  ----  | ----  |
  | 单元格  | 单元格 |
  | 单元格  | 单元格 |
  

• 对齐方式

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐。

• 实例

  | 左对齐 | 居中对齐 | 右对齐 |
  | :---- | :----: | ----: |
  | 单元格 | 单元格 | 单元格 |
  | 单元格 | 单元格 | 单元格 |
  

  左对齐	居中对齐	右对齐
  单元格	单元格	单元格
  单元格	单元格	单元格

Markdown 高级技巧

• 支持的Html元素

  不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。

  目前支持的 HTML 元素有：
等 ，如：使用 Ctrl+Alt+Del 重启电脑

• 转义字符(\)

  Markdown 使用了很多特殊符号来表示特定的意义，如果需要显示特定的符号则需要使用转义字符。

• 公式

  $$
  \mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
  \mathbf{i} & \mathbf{j} & \mathbf{k} \\
  \frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
  \frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
  \end{vmatrix}
  $$
  

  

---

1. 中会根据脚注在文中的顺序设定数字，不会显示自定义的脚注名称；在Typora中能够显示脚注名称。 ↩

2. 创建列表的符号后需加空格。 ↩