Markdown 语法学习
Markdown 语法学习
参考链接
- The CommonMark website, with information on the project.
- The CommonMark discussion forum, where questions and changes to the specification can be proposed.
- The CommonMark specification
- The reference C Implementation
- Our fork with support for all GFM extensions
- The GFM specification, based on the original spec.
- A list of CommonMark implementations in many programming languages
- HTML:HyperText Markup language 但是其中的
markup
和markdown
并没有什么关系。 - markdown文件可以导出HTML格式、PDF格式和md格式等。
- 一般的,语法符号和文本之间要有空格,否则不识别。
- 一般的,默认单个回车视为空格,连续回车才能分段。行尾加两个空格才为段内换行。
粗体和斜体(注意:符号和文字之间没有空格)
- 形如
*
文字*
之间的内容为斜体。等价的形式:_
文字_
- 形如
**
文字**
之间的内容为粗体。 - 形如
***
文字***
之间的内容为加粗斜体。 - 形如
~~
文字~~
之间的内容为删除字体。
分割线
三个 *
号是一条分割线。
标题
- 文字前面加上n个
#
,就说明是n级标题。最多允许六级标题。- 文字换行后加至少2个
=
也表示一级标题。 - 文字换行后加至少2个
-
也表示二级标题。
- 文字换行后加至少2个
- 在段落中填写
[TOC]
可以显示全文内容的目录结构。
引用
- 文字前面加上
>
表示引用。引用范围为连续的多行,直到空行结束。 - 可以用多个
>
同时配合单个空行控制格式,实现引用的嵌套。
代码框
用一对反引号``框起来的文本
为单行代码框。
用三对反引号``框起来
可实现多行代码段。
将一段代码前总体加上4个空格或2次Tab可实现多行代码段。代码段前方必须有空行。
链接和图片
常用的方式
也可用索引方式把url都列在文章的最后
还有一种最简单但不美观的方式
列表
- 两个列表之间不能相邻,否则会解释为嵌套的列表。
- 列表结束时在后面保证有一个空行,才会解释为列表结束。
- 如果要在列表中间的某个项目中添加一个空行,需要在空行后的列表项目开头加2个空格或1个Tab。
无序列表
文字前面加上 *
+
-
三种符号中的任一符号。三种符号没有区别,可以任意混用。
有序列表
文字前面加上 1.
2.
3.
等。
可以使用 1\. Text
的形式,阻止有序列表的生成。
表格
形如:
| 表头 | 列1 | 列2 | 列3 |
|---------|:--------|:------:|-------:|
| 行1 |左 |中 |右 |
| 行2 |默认左对齐| | |
| 行3 |左对齐 |居中对齐 |右对齐 |
表头 | 列1 | 列2 | 列3 |
---|---|---|---|
行1 | 左 | 中 | 右 |
行2 | 默认左对齐 | ||
行3 | 左对齐 | 居中对齐 | 右对齐 |
锚点
注脚
在需要添加注脚的文字后加上注脚名字[^foot]。在文本的任意位置(一般在文末)添加注脚。注脚前须有对应的注脚名字。