Markdown 语法
markdown背景特点
markdown优点
- markdown是一种用于写作的纯文本标记语言。
- 专注于文字,而不是排版
- 标记语法简单易用,几乎所有的文本编辑器都能打开。
markdown语法
以下语法特点内容前期了解,需要和后面具体使用用例做融汇映射。
- markdown 编写的文档,以
.md
,.markdown
后缀标识。- markdown 语言是一种目录框架式标识语言,内容标识后,可分为两类。以书籍为例,第一类内容标识像书的目录(markdown称为标题,显示在编辑器上的大纲),第二类内容标识像书籍具体章节内容上包含的内容块。
- markdown 语言标识符,一般是特殊符号。从符号个数上分为两类:对称的标识符和内容强调的单个前置标识符。
- markdown语言,默认一行是一个单位语句。多个相同的单位语句组成语句块,在源代码编辑,每个语句块上下需要空一行。
- 缩进和空格。缩进默认是两个空格。空格,在行内正常显示,注意行首四个空格表示代码块。
目录(标题)
标题的标识符有两种格式。
- 第一种是使用
=
和-
做标记,做一级和二级标题,知道即可,不常使用。 - 第二种使用
#
号表示1-6级标题,每一级对应相应数字的#
号。注意#
号和内容间有一个空格,另外查看大纲显示效果。
不同等级标题包含下一级:
- 可包含多个下一级。
- 不能直接跳级(如一级后,没有二级标题,直接跟三级标题)。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
标题包含的元素
标题是整个文章的目录结构。它主要包含段落(正文),及其它修饰内容,如引用、插图、链接、代码块、列表、表格、流程图等。
段落
段落是标题所包含的内容正文。它使用的标识符分为段落的格式,及段落文字修饰。
段落格式
段落没有特殊格式,可直接编写文字。但需要注意的是,源代码编辑时,段落的换行。
- 段落换行以两个空格加上
Enter
回车键结尾。 - 在段落后加一空行表示开始新的段落。
1 段落1换行。 ↓ \\末尾空两格
2 段落2
1 段落换行。
2 \\加空行
3 段落换行。
段落文字修饰
段落文字修饰,分为字体、分隔符、文字标记等。
字体
markdown 常使用字体包括:一般字体、斜体、粗体 、斜粗体 等。
字体使用对称标识符,用*
或_
来修饰,但建议这三种字体使用一致的格式符号修饰,如都用*
,以便于文档更容易理解。
*斜体* ,**粗体** , ***粗斜体*** \\使用 * 星号,强调字体。
_斜体_ ,__粗体__ , ___粗斜体___ \\使用 _ 星号,强调字体。
分隔符
分隔符单独占一行,除三个或三个以上标识符号外(*
、-
、_
),行内不能有其它字符。可在标识符内插入空格。
***
------
_ _ _ _
文字标记
文字标记,使用对称标识符,给文字添加特殊标识。
-
删除线,文字两端加上两个波浪线~~
。 - <u>下划线</u>, markdown没有下划线,需通过HTML标签
<u>
来实现。 - 脚注,对文本补充说明。 格式:
[^脚注]
,在后面需要再添加补充文字:[^脚注]:补充说明文字。
-
函数
、片段代码
、按键
等特殊标记。上面的文字标记即使用该效果,标识符是前后两个反引号(1前面按键). - 上标:X2,下标:O2
~~删除线~~,
<u>下划线</u>, <u>下划线</u>,[^脚注]。
`特殊标记`
X<sub>2</sub> , O<sup>2</sup>
[^脚注]:对文本补充说明