【Markdown 从入门到精通】
虽然 Markdown 扩展语法不在 CommonMark Spec 标准中,但许多 Markdown 编辑器也都尽量支持,因此学习一些常用的 Markdown 扩展语法也是有必要的。本文介绍的主要是 GitHub Flavored Markdown,也就是 GitHub 风格的 Markdown 扩展语法。
# 删除线
使用两个飘号 ~~
包裹需要表示删除的文字。
~~抽烟~~ |
# 下划线
由于 Markdown 和 HTML 的暧昧关系,因此在 Markdown 中,下划线可以通过 <u> </u>
标签来实现。
<u>下面有条线</u> |
# 上标与下标
上标使用 ^
包裹
a^2^ |
下标使用 ~
包裹
CO~2~ |
# 高亮
用两个等号 ==
包裹表示高亮
==我会变亮哦== |
# 锚点
锚点的作用是标记文档中的特定位置,使用锚点可以跳转到当前文档或其他文档中指定的标记位置(可以理解为相对链接)。锚点常见于目录链接,因此有时候也称其为书签。锚点的语法格式如下:
[锚点描述](#锚点名) |
语法说明:
- 锚点名不能含有空格;
- 锚点名不能含有特殊字符;
- 锚点名是区分大小写英文字母的;
- 锚点名建议使用字母和数字,也可以使用中文,不过要留意你所使用的编辑器或部署的网站是否支持。
示例:
# 目录 | |
- [第1章](Chapter1.md) | |
- [第1章 第1节](Chapter1.md#Section1) | |
- [第1章 第2节](Chapter1.md#Section2) |
在 Chapter1.md 文档中,创建 Section1 和 Section2 标题
# Chapter1 | |
## Section1 | |
## Section2 |
# 表格
表格的处理在 Markdown 中是比较有争议的,但大多数都遵循下面这种简单的表格标记语法:
表头1 | 表头2 | 表头3 | |
---- | ---- | ---- | |
内容1 | 内容2 | 内容3 | |
内容4 | 内容5 | 内容6 |
语法说明:
- 单元格使用竖线
|
进行分隔; - 表头与内容行使用短横线
---
分隔; - 默认左对齐,可以在短横线在左侧或右侧添加冒号
:
来调整对齐方式,比如:- 左对齐
:---
- 右对齐
---:
- 居中对齐
:---:
- 左对齐
# 待办事项
待办事项也就是 Check Box,在 Markdown 扩展语法中的格式如下:
- [ ] 未勾选 | |
- [x] 已勾选 |
语法说明:
- 方括号内填充小写字母 x 表示选中,填充空格表示未选中;
- 方括号外面两边的空格是必须的。
# 数学区块
Markdown 扩展语法支持 LaTeX 数学表达式,使用 $
符包裹 LaTeX 表达式即可。与代码块类似,数学表达式也分为 “行内” 和 “块” 两种。
行内数学表达式:
$\Delta+1$ |
数学表达式块:
$$ | |
\Delta+1 | |
$$ |
语法说明:
- 行内表达式使用一个
$
包裹; - 块表达式使用两个
$$
包裹。
LaTex 表达式比较复杂,后面会专门用一个篇幅来介绍。
# 表情符号
Markdown 是支持 Emoji 表情的,格式是使用冒号 :
包裹表情代码。
:表情代码: |
示例:
<span class="github-emoji" alias="smile" style="" fallback-src="https://github.githubassets.com/images/icons/emoji/unicode/1f604.png?v8">😄</span> |
表情的使用关键在于要知道支持哪些表情代码,后面也会专门用一个篇幅来介绍这个有趣的话题。
# 目录
Markdown 的标题本身可以作为目录,但是如果想在为当前文章增加目录,可以使用 [TOC]
自动生成目录。
@[toc] |
# 注脚
注脚(也称为脚注,英文 footnote)用于为正文条目补充注解,常见于论文引用资料来源的说明。在 Markdown 中注脚的写法与 上一节 讲的参考式链接类似,格式如下:
正文条目[^注脚] | |
[^注脚]: 引用描述 |
示例:
66.7%的受访者选择“就地过年”,中国铁路春运客流将下调至2.96亿人次,较往年同期下降了六成。[^1] | |
[^1]: [报告显示:超过六成职场人选择“就地过年”](https://finance.sina.com.cn/china/gncj/2021-01-25/doc-ikftpnny1714325.shtml) |
# YAML 头信息
如果你使用过 Hexo、Jekyll、Sphinx 等静态网站生成工具写博客或制作在线文档,你就会看到 Markdown 文档的头部有一些信息,这个头部信息就是 YAML 头信息。它的作用是描述该文档的信息,不会显示出来,类似于 HTML 的 <head> </head>
包裹的头部信息。
YAML 头信息必须放在文件的开始位置,并且需要按照 YAML 的格式写在两行三虚线 ---
之间。
比如你现在看到的这篇文章的 YAML 头信息是这样的:
--- | |
title: 了解常用Markdown扩展语法 | |
date: 2021-03-07 09:51:19 | |
tags: | |
- Markdown | |
- 教程 | |
categories: Markdown从入门到精通 | |
--- |
YAML 头信息的字段与你所使用的工具有关,具体的字段需要结合相关的工具来填写。后面我们讲博客和在线文档搭建的时候会详细介绍,现在你只要知道有这个东西就可以了~
# 图表
Markdown 扩展语法支持图表,但不同工具对图表的支持和兼容差别较大,后面会安排专门的章节来展开描述。
关于 Markdown 扩展语法的介绍就先到这里啦,别忘了把上述示例复制到你的 Markdown 编辑器中看看效果哦。