Markdown必知必会

Markdown 必知必会

概述

Markdown 是一个轻量级的标记语言，使创造者更专注于内容而不是样式排版,可在 Markdown 中直接使用 HTML 标签。

基础语法

原文地址：Markdown 基础语法，Typora Markdown 语法

块级元素

标题

以#开头，以 1-6 个#对应标题级别 1-6，对应 html 中的<h>标签

# 标题 h1

## 标题 h2

段落

使用一个或者多个空行来划分段落，普通段落不应有缩进格式，通常会被转化为<br/>标签

引用

在行的开头使用>来表示引用，引用可以互相嵌套

> 这是一个引用
>
> > 这是一个嵌套的引用

列表

列表分为有序列表和无序列表

有序列表以数字加. 显示，无序列表以+ - \* 表示

1. 有序列表
2. 有序列表

- 无序列表
- 无序列表

任务列表

• todolist
• todolist 选中状态

- [ ] todolist
- [x] todolist

表格

表格使用|来分隔不同的单元格，使用一个或多个-来区别表头和其他行

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

代码块和数学块

代码块用来输出编程语言和标记语言。使用一对```来表示代码区域， 可在第一个设置代码块的解释语言。

`javascript console.log('hello') ​`

数学块用来输出数学表达式。使用一对$$来表示数学表达式区域，使用 LaTex 的语法。

$$a÷b=\frac{a}{b}$$

$$
a \div b =\frac{a}{b}
$$

LaTex: 基于 Tex 排版系统的一种排版格式，常用于生成复杂的表格和数学公式。vscode 中使用 LaTex，LaTex 语法文档 ↩

目录

使用单独的一行[toc]表示目录 table of content，目录会随标题变化而变化

脚注

添加脚注后，当鼠标悬停的时候会有显示注释。

LaTex [^1]常用于生成复杂的数学公式.
[^1]:基于 Tex 排版系统的一种排版格式，常用于生成复杂的表格和数学公式

分隔线

使用***表示分割线

---

内联元素

链接

使用中括号加小括号表示链接，有两种方式：内联和引用

内联方式：[名称](url链接或相对路径)
引用方式：
[name][id]
[id]:(url 链接或相对路径)

图片

在 markdown 的写作过程中图片保存可以放在线上或者放在本地管理。目前的文章的图片都是配置在了本地通过相对路径引用。

内联格式：![alt text](url链接或相对路径)
引用格式：使用 id 来替代，
![alt text][id]
[id]:url 链接或相对路径

强调、删除线和高亮

斜体，加粗，删除线，高亮

_斜体_，**加粗**，~~删除线~~，==高亮==

代码和数学表达式

行内代码，$1+2=3$，数学表达式使用文档

`行内代码`,$1+2=3$

上下角标

角标_下 ，角标^上

角标~下~ ，角标^上^

HTML 支持和 emoji 表情

可以使用 html 标签去扩展原生 Markdown 不支持的功能.

支持 UTF-8 编码的 emoji 表情,使用:haapy:表示 emoji :happy:，¹ GitHub 支持的 emojis

支持 iframe,video,audio
:happy:

时序图、流程图、思维导图

Typora 下的使用 markdown 画图指南

时序图：使用 js-sequence 插件，js-sequence 文档