本文是作者在学习完Markdown语法后写的整理笔记,用于自己助记、速查。若后期修改则直接在原文中添加,不会注明修改内容及日期。
基本语法:
功能 | MD语法 | HTML语法 | 备注 |
---|---|---|---|
标题 | # 内容 | <h1>内容</h1> | 注意有空格,#对应h1,##对应h2,######对应h6,数字增大字体变小,#后有空格。也可以用文本下方加==或--的方法 |
换行 | 行内容,空格空格回车,行内容 | <p>行内容<br>行内容</p> | 多个空格也可以,不换行则导出为html时内容全在一行里,换行间距是单倍。Typora是回车换行,几乎所有编辑器支持<br>回车换行 |
段落 | 段落内容,隔行,段落内容 | <p>段落内容</p><p>段落内容</p> | 不可用空格或制表符进行缩进,md文档没有缩进功能,隔多行导出后仍然一行,段落间距是双倍 |
斜体 | 内容*斜体内容*内容 | 内容<em>斜体内容<em>内容 | 也可以用_ |
粗体 | 内容**粗体内容**内容 | 内容<strong>粗体内容<strong>内容 | 也可以用__ |
粗斜体 | 内容***粗斜体内容***内容 | 内容<strong><em>粗斜体内容<em><strong>内容 | 也可以用___ |
区块 | >段落内容 | `` | 区块可以嵌套 |
有序列表 | 1. 内容,换行,数字. 内容,换行,数字. 内容 | <ol><li>内容</li><li>内容</li><li>内容</li></ol> | 数字可以任意写,显示效果是按序排列的,开头必须数字1,列表中嵌套列表及其他元素要缩进一个制表符,注意点后有空格 |
无序列表 | + 内容,换行,+ 内容,换行,+ 内容 | <ol><li>内容</li><li>内容</li><li>内容</li></ol> | 也可以用-或* |
代码行 | `内容` | <code>内容</code> | 可以换行,不能分段落,内部有反引号则用双反引号 |
代码块 | 制表符,内容 | `` | `` |
分隔线 | 内容,隔行,---,隔行,内容 | `` | 也可以用***或___,隔行是为了兼容性 |
超链接 | [超链接显示名](超链接地址 "超链接title")或<超链接地址> | <a href="超链接地址" title="超链接title">超链接显示名</a> | 链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,地址可以是Email。不同编辑器处理URL中间的空格方式不一样,为了兼容性,使用%20代替空格 |
插入图片 |  | <img src="图片链接" alt="图片alt" title="图片title"> | alt属性是图片未显示时的替代文本,图片附带超链接则将本句放在超链接语法的地址位置 |
扩展语法:
功能 | MD语法 | HTML语法 | 备注 |
---|---|---|---|
表格 | | 标题 | 标题 |,换行,| :----------- | -----------: |,换行,| 内容 | 内容 | | `` | 使用Markdown Tables Generator的图形界面构建表,然后将生成的Markdown格式的文本复制到文件中,才更快。左侧,右侧或两侧添加冒号(:),将列中的文本对齐到左侧,右侧或中心 |
围栏代码块 | ~~~,换行,代码块,换行,~~~ | ||
脚注 | 内容[^标识符],换行,内容,换行,[^标识符]:脚注内容. | `` | 标识符可以是数字串或字母串,脚注内容部分可以放在除列表、块引号和表之类的其他元素之外的任何位置 |
标题ID | # 内容{#自定义ID} | <h1 id="自定义ID">内容</h1> | #自定义ID可以被超链接使用当书签 |
删除线 | ~~内容~~ | `` | `` |
下划线 | <u>带下划线文本</u> | <u>带下划线文本</u> | `` |
文本居中 | <center>内容</center> | `` | `` |
任务列表 | - [x] 内容,换行,- [] 内容 | `` | 任务列表使您可以创建带有复选框的项目列表 |
禁用自动URL链接 | `地址` | 许多编辑器会自动将URL转换为链接,即使未使用方括号,编辑器也会自动将其转换为链接 | |
上标 | 2^n^ | 2<sup>n</sup> | `` |
下标 | ~2~n | <sub>2</sub>n | `` |
半角空格 | | | `` |
半角空格 |   |   | 占据的宽度正好是1/2个中文宽度 |
全角空格 |   |   | 占据的宽度正好是1个中文宽度 |
其他:
- 可以插入LaTeX的数学公式、UML的图、流程图、甘特图。
- 转义字符:\ 加 \ 、` 、+ 、* 、 、- 、 、_ 、 、() 、 、[] 、 、{} 、 、# 、 、. 、 、! 、 、| 。<和& 会被编辑器自动转换成HTML实体,但若不作HTML实体如小于符号、逻辑与符号则要转义。
- Markdown支持HTML标签,不需要额外标注,行级内联标签直接书写,区块标签需要前后隔行,并且不可以缩进。
- 各类MD编辑器以及优快云等平台,对MD语法的扩展不同,但基础语法是一致的。不同之处需要百度。