本文主要关注Markdown使用时的高级用法和一些容易出现问题的地方,Markdown的基础用法大家可以查看简书官方关于Markdown的指南。本文主要包含6个方面的内容:
一、空格的使用:
标题字符(#)
,列表字符( - / + / * / 1. / 2.)
,引用字符(>)
和文本之间要
保留一个字符的空格
。这是最标准的 Markdown 写法。这会避免因为Markdown编辑器的差异而出现显示的效果不一致的情况出现。
标题字符(#):
代码:
# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题
无序列表字符( - / + / * ):
- 文本1 + 文本2 * 文本3
有序列表字符(1. / 2. / 3.):
1. 文本1 2. 文本2 3. 文本3
引用字符(>):
> 引用文本
二、列表和代码块的对齐
(1)多级列表的对齐:
建立多级列表时,每个子级别都要比上个级别前面多打2个空格。
无序列表:
- Item-1 - Item-1-1 + Item-1-1-1 * Item-1-1-1-1 * Item-1-2 + Item-2 * Item-3
有序列表:
1. Item-1 1.1. Item-1-1 1.1.1. Item-1-1-1 1.1.1.1. Item-1-1-1-1 1.2. Item-1-2 2. Item-2 6. Item-3
(2)一个列表内部多个段落的对齐:
对应列表中的包含多个段落时,该列表下对应的各个段落的开头都要与第一个段落的开头对齐,如下面的例子中Code Line 1,Code Line 2和Code Line 3的开头是对齐的.
* Item-1
* Code Line 1
Code Line 2
Code Line 3
编辑器解析的效果:
- Item-1
- Code Line 1
Code Line 2
Code Line 3
- Code Line 1
(3)代码块的对齐
代码块内部的对齐:
代码块使用字符构建时,文本的内容要与字符的位置对齐,如下面例子中的Code Line 1,Code Line 2和Code Line 3的开头都与字符的开头对齐了
Code Line 1
Code Line 2
Code Line 3
代码块与列表的对齐:
在列表下的代码块字符的开头要与列表对应的段落开头对齐,比如下面这个例子对于Item-1.1下面的代码块,就是Item-1.1的开头与的开头对齐了
- Item-1
- Item-1.1
Code Line 1
Code Line 2
Code Line 3
- Item-1.1
- Item-1
三、网址链接的两种方式
Markdown关于添加图片和网址的语法很相似,只是插入图片的语法比插入网址前面多了一个感叹号”!”.它们都有两种插入方式,分别是:行内式和引用式(名字不重要,是我为了方便称呼自己取的)
注:Markdown不能设置图片的大小,如果必须设置,则应用HTML标记.
(1)行内式:
图片:
[百度的图标](/path/to/img.jpg "Title(可以省略)")
网址: