markdown是一种纯文本轻量级标记语言,有点类似html语言,通过简单的语法使文本拥有一定的格式;
我使用的是一个在线编辑器:Editor.md - 开源在线 Markdown 编辑器,有增强功能,感觉GitHub上的md编辑器更标准;
基本语法:
标题:
标题文字前面加#,一共6级标题,由#个数决定,文字和#之间最好加一个空格;
github上的md编辑就需要#后面的空格:
还有一种写法只支持一二级标题,在文字下方添加至少2个“=”或者“-”;
段落:
用空行分割段落;
换行符:
使用至少两个空格结束一行并回车:(那个在线编辑器会自动换行)
字体:
加粗:在文字前后各加2个*或者_
斜体:在文字前后各加1个*或者_
加粗和斜体可以嵌套使用:
删除线:在文字前后各加2个~
另外,在单词中间加粗或斜体需要使用*不能用_
块引用:
段落前面加一个>符号:
也可以通过追加>符号嵌套:
分割线:
在一行上使用至少3个*或者-或者_,中间可以有空格:
注意,---可能与标题冲突,需要空行隔开:
列表:
无序列表:在项目前面加+或者-或者*
有序列表:在项目前面加数字,并且数字后面跟一个点,数字不需要顺序,会从1开始标记
每项前面加空格提高兼容性:
列表可以嵌套:
代码:
行内代码:反引号`括起来
代码块:前后各使用```括起来
链接:
普通链接:方括号将文本括起来,后面跟小括号括起来的url地址;url后面可以跟引号括起来的文字,用于鼠标悬停显示;
[链接文本](url "鼠标悬浮显示")
参考式链接:由两块组成,第一块两个[],分别指定文本和标签,第二块[]加url,指定标签的具体url,还可加鼠标悬停,在url后面用双引号或者括号括起来;第二块位置可随意;
[链接文本] [标签]
[标签]: url (鼠标悬浮显示)
图片:
跟链接很像,前面加一个!就可
![图片替代文本](图片url "悬停显示")
表格:
列之间用|分割,第一行为表头,第二行为表头和内容分割线,第二行每一列内容为至少一个“-”符号,第二行可以设置该列字体对齐方式,-左边加:表示左对齐,右边加:表示右对齐,两边都加:表示居中对齐,标准语法需要在表格最左侧和最右侧也要加|
转义字符:
对于特殊字符需要使用\符号进行转义,需要转义的字符有:
- \ 反斜杠
- ` 反引号
- * 星号
- _ 下划线
- {} 花括号
- [] 方括号
- <> 尖括号
- () 小括号
- # 井号
- + 加号
- - 减号
- . 点
- ! 感叹号
- | 竖线
嵌入HTML标签:
许多markdown程序都支持部分html标签,可以用来调整字体颜色或者图片大小等等;
另外,好多markdown语法可以嵌套,但并非全部可嵌套:
一些高级markdown编辑器还支持流程图、LaTex数学表达式等;
参考: