一. markdown基础语法
1. 标题(heading)
要创建不同级别的标题,只需要在标题前面加上#
,#
的数量越多,表示标题的等级越小。
语法 | 预览效果 |
---|---|
# heading level 1 | head level 1 |
## heading level 2 | head level 2 |
### heading level 3 | head level 3 |
#### heading level 4 | head level 4 |
##### heading level 5 | head level 5 |
###### heading level 6 | head level 6 |
注意:# 或者多个 **### **符号要与标题信息有一个空格间隔,markdown才能识别其为标题。
2. 段落 (paragraph)
要创建段落,使用空白行将一行或多行文本进行分隔,不要用空格(spaces)或制表符( tabs)缩进段落。
I really like using Markdown.
I think I'll use it to format all of my documents from now on.
3. 换行 (line break )
在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行<br>
,几乎每个 Markdown 应用程序都支持两个或多个空格进行换行,称为 结尾空格(trailing whitespace)
的方式,但这是有争议的,因为很难在编辑器中直接看到空格,并且很多人在每个句子后面都会有意或无意地添加两个空格。由于这个原因,你可能要使用除结尾空格以外的其它方式来换行。幸运的是,几乎每个 Markdown 应用程序都支持另一种换行方式:HTML 的 <br>
标签
语法 | 预览效果 |
---|---|
如何正确地使用<br> markdown | 如何正确地使用 markdown |
4. 强调
(1)粗体 (blod)
要加粗文本,请在单词和短语的前后各添加两个星号或者两个下划线。如果是加粗某个单词中间的某个部分,就在想要加粗的部分的前后各添加两个星号。
语法 | 效果预览 |
---|---|
如何正确地__ 使用__ markdown | 如何正确地__使用__markdown |
如何正确地使用** markdown** | 如何正确地使用markdown |
如何正确地使用** mark** down | 如何正确地使用markdown |
(2)斜体(ltalic)
要使文本显示为斜体,请在单词和短语的前后各添加一个星号或者一个下划线。如果是加粗某个单词中间的某个部分,就在想要加粗的部分的前后各添加一个星号。
语法 | 效果预览 |
---|---|
如何正确地_ 使用_ markdown | 如何正确地_使用_markdown |
如何正确地使用* markdown* | 如何正确地使用markdown |
如何正确地使用* mark* down | 如何正确地使用markdown |
(3) 斜体(blod)和粗体(ltalic)
要使文本显示为斜体,请在单词和短语的前后各添加三个星号或者三个下划线。如果是加粗某个单词中间的某个部分,就在想要加粗的部分的前后各添加三个星号,还可以将_
和 *
交替使用。
语法 | 效果预览 |
---|---|
如何正确地___使用 ___`markdown | 如何正确地___使用___markdown |
如何正确地使用*** markdown*** | 如何正确地使用markdown |
如何正确地使用*** mark*** down | 如何正确地使用markdown |
如何正确地使用**_ mark_** down | 如何正确地使用**mark**down |
如何正确地使用__* mark*__ down | 如何正确地使用__mark__down |
5. 引用
(1)多个段落的引用块
要创建引用块,在段落前添加一个>
语法
> html
> css
> javasript
效果预览
html
css
javascript
(2)嵌套块引用
> html
> css
>> javascript
效果预览
html
css
javascript
(3) 带有其他标签的引用块
语法
> ## 前端
>> - html
>> - css
>> - javascript
效果预览
前端
- html
- css
- javascript
6.列表
(1)有序列表
要创建有序列表,在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。
语法 | 效果预览 |
---|---|
1. html 2. css 3. javascript | 1. html 2. css 3. javascript |
1. html 6. css 7. javascript | 1. html 2. css 3. javascript |
(2)无序列表
要创建无序列表,在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。
语法
- html
- css
- javascript
* html
* css
* javascript
+ html
+ css
+ javascript
效果预览
- html
- css
- javascript
- html
- css
- javascript
-
html
-
css
-
javascript
7. 代码
要将单词或短语表示为代码,将其包裹在反引号 `
中。
语法 | 预览效果 |
---|---|
let `count = 0 ` | let count = 0 |
如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号````中。
语法 | 预览效果 |
---|---|
``let `count = 0 ` `` | let `count = 0` |
8.分隔线
要创建分隔线,请在单独一行上使用三个或多个星号 ***
、破折号 ---
或下划线 ___
,并且不能包含其他内容。三种方式的渲染效果都是一样的。
语法
***
---
___
效果预览
9. 链接
(1)超链接
链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。
语法代码:[超链接显示名](超链接地址 "超链接title")
语法
这是一个前往[百度的链接](https://www.baidu.com '百度')
效果预览
这是一个前往 markdown语法 的链接
(2) 网址和Email地址
如果是网址和Email地址,可以在其两端添加< >
语法
<https://www.baidu.com>
<1234567890@qq.com>
效果预览
https://www.baidu.com
1234567890@qq.com
10.图片
(1)图片基本用法
要添加图像,请使用感叹号 !
, 然后在方括号增加替代文本(替代文本对应的是html标签中的alt属性,在图片加载失败时或者无法显示是会代替图片展示,所以可以写一些能描述或代替图片的文本),图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本(标题文本对应的是html中的title标签,当我们的鼠标悬停在图片上时,标题文本就会显示出来)。
插入图片Markdown语法代码:![图片alt](图片链接 "图片title")
。
![这是一张风景图](https://i1.3conline.com/images/piclib/200912/28/batch/1/50775/1261981340895sbzeca5ic3.jpg "mountian")
(2)链接图片
给图片增加链接,要将整个图片的markdown语法用[ ]
括起来,然后在后面添加一个( )
并将链接填写在园括号内
[![这是一张风景图](https://img-blog.csdnimg.cn/41905e56c13e4efa895b576d52fda786.jpeg "mountian")](https://www.baidu.com)
11.转义字符
要显示原本用于格式化 Markdown 文档的字符,可以在字符前面添加反斜杠字符 \ 。
Character | Name |
---|---|
\ | backslash |
` | backtick (see also escaping backticks in code) |
* | asterisk |
_ | underscore |
{ } | curly braces |
[ ] | brackets |
( ) | parentheses |
# | pound sign |
+ | plus sign |
- | minus sign (hyphen) |
. | dot |
! | exclamation mark |
| | pipe (see also escaping pipe in tables) |
二. 扩展语法
1.表格
(1)基本用法
要添加表,需要使用三个或多个连字符---
创建每列的标题 ,并使用管道 |
分隔每列。
| 语法 | 预览效果 |
| -------- | ------- |
| *** | ———— |
| --- | —————— |
语法 | 预览效果 |
---|---|
*** | —————— |
— | —————— |
(2)对齐方式
可以通过在标题行中的连字符的左侧,右侧和两侧添加:
:-------
左侧对齐
-------:
右侧对齐
:------:
中间对齐
语法
| 字母 | 单词 | 句子 |
| :--- | :----: | ---: |
| H | Title | Here's this |
| P | Text | And more |
字母 | 单词 | 句子 |
---|---|---|
H | Title | Here’s this |
P | Text | And more |
注意:可以在表格中添加链接,代码(只能用反引号 ` ,不能用代码块),强调和换行,不能添加标题,块引用,列表,水平规则或者html代码
2.围栏代码块
要创建代码,可以在代码之前和之后的行上使用三个反引号````或者 三个波浪号
~~~ `
且可以为编写的任何语言进行语法高亮,在在代码之前的三个反引号 ````或者
~~~ ` 后面添加上对应语言到名称
语法
```javascript
let sum = 0
for(let i = 0; i < 10; i ++){
sum += i
}
console.log(sum)
```
效果预览
let sum = 0
for(let i = 0; i < 10; i ++){
sum += i
}
console.log(sum)
语法
~~~c
int sum = 0,i = 0;
for(i = 0; i < 10; i ++){
sum += i;
}
printf("%d", sum);
~~~
效果
int sum = 0,i = 0;
for(i = 0; i < 10; i ++){
sum += i;
}
printf("%d", sum);
3.任务列表
要创建任务列表,可以在任务列表项之前添加破折号 -
和方括号[ ]
, 并在[ ]
前面加上空格。要选择一个复选框,在方括号[]
之间添加x
,如[x]
,如果不选择,那么它的左右方括号之间也需要添加一个空格
语法
- [x] html
- [ ] css
- [ ] javascript
效果预览
- html
- css
- javascript
4.删除线
可以通过在单词中心放置一条水平线来删除单词。此功能使您可以指示某些单词是一个错误,要从文档中删除。若要删除单词,可以在单词前后使用两个波浪号~~
。
语法
~~css and html~~ javascript
效果预览
css and html javascript
5.定义列表
要创建定义列表,在第一行上键入术语。在下一行,键入一个冒号,后跟一个空格和定义(只有一些markdown处理器支持)。
语法
前端
: css
: html
后端
: java
: node.js
效果预览
-
前端
- css
- html 后端
- java
- node.js
注:我用typora写的,好像不支持定义列表的语法
本文总结了一些比较常用的markdown语法,更多markdown语法请到Markdown官方教程https://markdown.com.cn/查看