Markdown语法合集

目录页

• 1. Markdown使用平台
  • 1.1. VS Code 平台
    • 1.1.1. 安装链接
    • 1.1.2. Markdown使用的插件安装
      • 1.1.2.1. Markdown All in On
      • 1.1.2.2. Markdown Preview Enhanced
• 2. 文件转化
  • 2.1. Markdown导出为Pdf
• 3. 普通文本编写规则
  • 3.1. 标题使用样式
  • 3.2. 标题目录的生成
  • 3.3. 自动添加章节号码
  • 3.4. 常规格式
  • 3.5. 段落间的操作
  • 3.6. 列表的建立
    • 3.6.1. 有序列表
    • 3.6.2. 无序列表
    • 3.6.3. 可选列表
• 4. 引用的相关操作
  • 4.1. 正文中引入代码
  • 4.2. 代码块
  • 4.3. 引用文本
  • 4.4. 超链接
  • 4.5. 脚注的引用
  • 4.6. 自动链接
  • 4.7. Markdown内部的自引
  • 4.8. 小表情图标的插入
  • 4.9. 表格的插入
  • 4.10. 图片的插入
    • 4.10.1. 图片大小设置
    • 4.10.2. 调整对齐方式
• 5. 嵌入自定义的HTML内容
  • 5.1. 常用的HTML标签
    • 5.1.1. <!-- -->标签——注释
    • 5.1.2. <kbd>标签——键盘文本
    • 5.1.3. <a>标签——超链接
  • 5.2. 文本中字体的设置
  • 5.3. HTML标签制作合并单元格的表格
    • 5.3.1. 基本语法
    • 5.3.2. 对齐方式
    • 5.3.3. 整体制作效果
  • 5.4. 特殊要求
  • 5.5. 代码块的隐藏
  • 5.6. 图片的输入
    • 5.6.1. 图片大小的调整
    • 5.6.2. 图片对齐方式调整
    • 5.6.3. 关于添加图片的总说明
  • 5.7. 嵌入视频
• 6. 数学公式的引用
  • 6.1. 一般规则
  • 6.2. 行内公式
  • 6.3. 公式块
    • 6.3.1. 公式的书写
    • 6.3.2. 特殊符号的表示

---

1. Markdown使用平台

1.1. VS Code 平台

1.1.1. 安装链接

在VSCode软件官网下载安装包，完成软件的安装；

1.1.2. Markdown使用的插件安装

1.1.2.1. Markdown All in On

1.1.2.2. Markdown Preview Enhanced

2. 文件转化

2.1. Markdown导出为Pdf

使用vscode中的markdown预览增强插件（Markdown Preview Enhanced），右击点击会弹出各种导出选项，都没有用！导出的不好看，而且很折腾，而且要安装prince,pandoc之类的，有但不实用，推荐按照下述方法进行：使用插件Markdown Preview Enhanced, 预览界面右击选择open in brower, 在浏览器按ctrl+p打印, 并保存为pdf就好了。

3. 普通文本编写规则

3.1. 标题使用样式

注意： #与字符之间要有一个空格，如下图

标题使用样式

3.2. 标题目录的生成

操作如下：

1. 点在文本中需要插入目录的位置。
2. 通过Ctrl + Shift + P，打开命令板，选择Markdown All in One 下的Create Table of Contents，并执行。

3.3. 自动添加章节号码

操作：通过Ctrl + Shift + P，打开命令板，选择Markdown All in One 下的添加/更新章节序号

3.4. 常规格式

中文空格：中间嵌入 ，中文中文 中文中文
英文空格：中间嵌入 ，space key
加粗：文本左右各加两个“*”，如：加粗的文本，或者选中文本后按下Ctrl+B
倾斜：文本左右各加一个“*”，如：倾斜的文本，或者选中文本后按下Ctrl+I
既加粗又倾斜：结合加粗、倾斜的各自操作可知，在文本左右各加三个“*”即可，如：加粗倾斜的文本 ，这个操作结束了。
文本删除线：文本左右各加两个“~”，如：带删除线的文本
下划线：Markdown自身没有下划线，需要采用HTML的<u>标签实现，即写<u>下划线文本</u>，即可出现形如“下划线文本”的效果；
文本高亮/文本标记：高亮文本
文本上标：(x+3)^y
文本下标：(x+3)_y

具体设置的效果图如下所示：

常规文本设置

3.5. 段落间的操作

换行：文本后加两个空格，并按下Enter键，效果如下
新段：连续两个回车
分割线：在一行中使用三个或以上的减号（星号或底线效果一致），需要在两段之间加三个“*”，效果如下：

这是第一段

---

这是第二段

具体设置的效果图如下所示：

段落间的操作

3.6. 列表的建立

3.6.1. 有序列表

建立方法：序号（如：1,2,3……）后加空格,具体效果如下：

1. 第一项内容
2. 第二项内容
3. 第三项内容
   1. 子列表1
   2. 子列表2
      1. 子子列表
      2. 哈哈哈哈

具体设置的效果图如下所示：

有序列表的添加

3.6.2. 无序列表

建立方法：星号（*）或短线（-）后加空格,具体效果如下：

• 第一项内容
• 第二项内容
• 第三项内容
  • 子列表
  • 子列表

• 第一项内容
• 第二项内容
• 第三项内容

3.6.3. 可选列表

• 可选列表（需要选择时里面加任意字符）
• 可选列表

具体设置的效果图如下所示：

可选列表的添加

4. 引用的相关操作

4.1. 正文中引入代码

操作方法：加入一个上漂字符"`";
文本之间引入代码int a = 66正文中引入代码

4.2. 代码块

操作方法：在三个上漂字符之间输入相应代码(即代码段前后各三个上漂)，首行的上漂后可写入代码的语言，以便于解析。

以下是java代码：

public static void main(String[] args) {
   
    int a =666; //使用等号进行赋值运算
}

以下是Python代码：

if not os.path.exists(data_save_path):         # 确保目标目录存在
    os.makedirs(data_save_path)
    print("未找到相关数据")

具体设置的效果图如下所示：

代码的引入

4.3. 引用文本

操作方法：行首加一个>和空格 ，如：

引用别人文章中的句子，引用别人文章中的句子，引用别人文章中的句子，引用别人文章中的句子，引用别人文章中的句子，引用别人文章中的句子，引用别人文章中的句子，引用别人文章中的句子，引用别人文章中的句子，引用别人文章中的句子，引用别人文章中的句子，引用别人文章中的句子，

具体设置的效果图如下所示：

引用文本

4.4. 超链接

操作如下：需要超链接的文本放入方括号[]内，链接地址放入圆括号[]内，且超链接的目标路径应空一行后再写。

1. 加一个百度的超链接，如：百度、腾讯
2. 链接比较多时可以采用引用的格式，如：百度和腾讯

说明：

1. 正确的超链接引用，如：博文，语法为：[博文][博文]，这种将超链接放于[]内可正常跳转。
2. 错误的超链接引用，如：博文，语法为：[博文](博文)，这种将超链接放于()内不可正常跳转。
3. 超链接的语法为：[博文]: https://www.baidu.com。

超链接

4.5. 脚注的引用

操作方法：和超链接类似,引用一个脚注¹。

具体设置的效果图如下所示：

超链接 </