Markdown分享
作者:Ora.J
Makdown简介
Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。它由John Gruber于2004年创建,如今已成为世界上最受欢迎的标记语言之一
Markdown的优点:
- 专注文字写作
- 纯文本,易读易写
- 语法简单,学习成本低,排版简单
当听到排版,文字写作诸如此类的功能,你也许会想起一个软件,Word,你会有疑惑,既然功能类似,那么它与Word一类的编辑器又有什么不同。Markdown与Word有一个很大的区别就是Markdown的编辑页面使用Markdown语法,而不是对文字本身产生更改,Markdown的更改通过查找Markdown语法,指示文本中的内容的格式发生变化。接下来让我们一起去看看Markdown语法的使用吧!
##Markdown编辑器安装
使用Markdown之前,首先我们需要一款Markdown编辑器,Markdown编辑器多种多样,挑选一款适合你的,就可以开始你的Markdown之旅。我在本篇文章所使用的Markdown编辑器为*Typora*,我会以Typora为例介绍Markdown的一些基本语法。
Markdown基本语法
标题语法
创建标题,要在我们所编辑的内容之前添加井号(#),**#**的数量代表标题的级别。
使用井号的语法如下
# + 空格 + 标题内容 |
---|
格式规范:
- 标题前后保持间距,与其他内容之间尽量有空行(开头除外)
- 不要在末尾添加多余符号
- 标题尽量简洁
- 请用一个空格在
#
和标题之间进行分隔
段落语法
创建段落用空白行将一行或多行文本分隔,如果行与行之间没有空白行分割则视为一个段落。
注意:不要用空格键(space)或者(Tab)来缩进段落
✅ 推荐 | ❌ 不推荐 |
---|---|
不要按空格键(space)或者(Tab)来缩进段落. | 这会导致格式问题。不要在段落前添加制表符或空格,所以这是要注意的地方, |
换行语法
在Markdown中,换行通常使用两个或多个空格进行换行,成为结尾空格(trailing whitespace)
的方式,但是这对于操作来说是有难度的,因为在编辑器是较难看见空格的。所以另一种换行方式:HTML的
标签。另外至少有两种轻量标记语言支持无需在行末添加任何内容,只需键入回车键(return)即可实现换行。
注意:不推荐使用在行尾添加反斜杠(\)
的方式实现。因为不是所有的Markdown程序都支持此种方式,因此从兼容性的角度,不推荐使用。
强调语法
粗体(Bold):需要加粗的文本内容前后(两侧)各添加两个星号(**)
✅ 推荐 | ❌ 不推荐 |
---|---|
Love**is**bold | Love__is__bold |
注意:尽量使用星号**
,而不是下划线_
斜体(Italic): 需要斜体的文本内容前后(两侧)各添加一个星号(*)
✅推荐 | ❌ 不推荐 |
---|---|
A*cat*meow | A_cat_meo |
粗体(Bold)和斜体(Italic): 需要粗体和斜体的文本内容前后(两侧)各添加(***)中间不要有空格
✅ 推荐 | ❌ 不推荐 |
---|---|
This is really***very***important text. | This is really___very___important text. |
引用语法
创建块引用,请在段落之前添加一个>
符号
嵌套引用块:
块引用可以包含多个段落。为段落的空白行添加一个>
符号
> 我喜欢狗 |
---|
> |
> 狗狗特别可爱 |
渲染效果如下:
我喜欢狗
狗狗特别可爱
在有些Markdow编辑器中会出现如下结果:
我喜欢狗
狗狗特别可爱
而嵌套引用块语法则是如下:
> 我喜欢狗 |
---|
> |
>> 狗狗特别可爱 |
所以我们不推荐在空行内输入<,会导致某些格式错误。并且,>
尽量与内容之间有一个空格
> 我喜欢狗 |
---|
> 狗狗特别可爱 |
列表语法
有序列表:
创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字可以不按顺序排列,但起始应当以数字1起始。
1. First item |
---|
注意:有些轻量标记语言允许您用()
作为分隔符,但是并不是所有Markdown应用程序支撑此功能。所以请仅使用.(period)
✅ 推荐 | ❌不推荐 |
---|---|
1. First item2. Second item | 1) First item2) Second item |
无序列表
要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。 缩进一个或多个列表项可创建嵌套列表。由于星号*
容易与粗体和斜体混淆,所及建议使用-
。
* Firstitem |
---|
注意:Markdown并不支持同一列表来使用不同的分隔符,所以不要在同一个列表中混合分隔符使用,选择其中一个分隔符,并在列表中坚持使用。
✅ 推荐 | ❌ 不推荐 |
---|---|
- First item - Second item - Third item - Fourth item | + First item * Second item - Third item + Fourth item |
在列表中嵌套其他元素
要在保留列表连续性的同时在列表中添加另一种元素,注意请将要添加的该元素缩进四个空格或在该元素前面添加一个制表符
- 第一列 |
---|
- 第二列 |
>插入的额外列 |
- 第三列 |
渲染效果如下:
-
第一列
-
第二列
额外列
-
第三列
代码块
代码块通常采用四个空格或一个制表符缩进。 当它们被放在列表中时,请将它们缩进八个空格或两个制表符。
1. Open the file.
2. Find the following code block on line 21:
>><html>
><head>
<title>Test</title>
</head>
3. Update the title to match the name of your website.
渲染效果如下:
-
Open the file
-
Find the following code block on line 21:
Test -
Update the title to match the name of your website
图片
1. Open the file containing the Linux mascot.
2. Marvel at its beauty.
![Girl] (https://s2.loli.net/2024/09/26/tP7KXMWLBEbiqSc.png)
3. Close the file.
渲染结果如下:
-
Open the file containing the Linux mascot.
-
Marvel at its beauty.
-
Close the file.
列表
您可以将无序列表嵌套在有序列表中,反之亦然。
1. First item
2. Second item
3. Third item
- Indented item
- Indented item
4. Fourth item
渲染效果如下:
- First item
- Second item
- Third item
- Indented item
- Indented item
- Fourth item
注意:建议符号与列表内容之间尽量有一个空格,且数字和字母后面用英文句号
代码语法
行内代码:
Markdown中行内代码(单词或短语)使用`包裹
At the command prompt,type`node`.
####转义反引号:
如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号()中。
``Use `code` in your Markdown file.``
渲染效果展示:
Use `code` in your Markdown file.
代码块
要创建代码块,请将代码块的每一行缩进至少四个空格或一个制表符。
<html>
<head>
</head>
<html>
渲染结果展示:
<html>
<head>
</head>
<html>
假如创建不用缩进的代码块,使用围栏式代码块(fenced code blocks)
链接语法
链接文本放在中括号里面,链接地址放在后面的括号里面,链接title是可以选择的
超链接Markdown语法代码:[超链接显示名](超链接地址 “超链接title”)
这是一个链接[百度网址](https://www.baidu.com/index.htm)
渲染效果如下:
这是一个链接百度网址
给链接增加Title
链接Title是鼠标悬停在链接上会出现的文字,Title是可更改的,他放在圆括号中链接地址的后面,和链接地址之间以空格分隔
这是一个链接[CSDN](https://www.csdn.net/)
渲染结果入下:
这是一个链接CSDN
网址和Email地址
使用尖括号<
可以将URL或者email地址变成可点击的链接
<https://www.baidu.com/index.htm>
<fake@example.com>
渲染效果如下
https://www.baidu.com/index.htm
fake@example.com
带格式化的链接
强调链接,在链接的语法前加星号*
。要将链接表示为代码,在方括号内添加反引号`
I love supporting the **[CSDN](https://www.csdn.net/)**
This is the *[CSDN](https://www.csdn.net/)*
See the section on [`code`](#code)
I love supporting the CSDN
This is the CSDN
See the section on code
引用形式链接
引用链接是一种特殊的链接,使URL易读,它分为两部分:与文本相结合的部分以及存储在文件中其他位置的部分,简单理解为把链接地址在文件中其他位置定义,然后在文本中使用此链接的地方引用。
链接第一部分:
引用类型的连接的第一部分使用两组括号进行格式设置。第一组方括号[ ]
包围的内容应为链接的文本。第二组[ ]
显示了一个标签,该标签用于指向您存储在文档其他位置的链接。
我们在书写时,可以在第一组和第二组括号之间包含一个空格。第二组括号中的标签不区分大小写,可以包含字母、数字、空格或标点符号.
以下两种格式对于链接的第一部分效果相同
[CSDN][1]
[CSDN] [1]
链接的第二部分格式
引用型链接的第二部分使用以下属性设置格式:
- 放在括号中的标签,其后紧跟一个冒号和至少一个空格(
[label]:
) - 链接的URL,用尖括号
<
将它包裹,或者不做任何措施(不推荐)。 - 链接的可选标题,可以将其括在双引号
""
,单引号''
或括号之中
以下格式对链接的第二部分效果相同
[1]: https://www.csdn.net/
[1]: https://www.csdn.net/ "CSDN"
[1]: https://www.csdn.net/ 'CSDN'
[1]: https://www.csdn.net/ (CSDN)
[1]: <https://www.csdn.net/> "CSDN"
[1]: <https://www.csdn.net/> 'CSDN'
[1]: <https://www.csdn.net/> (CSDN)
渲染效果如下
可以将链接的第二部分放在Markdown文档中的任何位置。有些人将它们放在出现的段落之后,有些人则将它们放在文档的末尾(例如尾注或脚注)。
不同的Markdown应用程序处理URL中间的空格方式不同,尽量使用%20代替空格
✅推荐 | ❌不推荐 |
---|---|
[link](https://www.example.com/my%20great%20page) | [link](https://www.example.com/my great page) |
注意:链接尽量以http/https开头
分割线语法
要创建分隔线,请在单独一行上使用三个或多个星号 (***
)、破折号 (---
) 或下划线 (___
) ,并且行内不能包含其他内容。
***
---
___
渲染效果如下:
为了兼容性,请在分割线前后均添加空白行
✅ 推荐 | ❌ 不推荐 |
---|---|
我喜欢你 | 我喜欢你 |
— | |
— | 喜欢 |
喜欢 |
图片语法
要添加图像,请使用感叹号 (!
), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。
插入图片Markdown语法代码:![图片alt](图片链接 "图片title")
。
![这是图片](https://i-blog.csdnimg.cn/direct/b4e37025632145d7b1ea7b7843726f2b.jpeg#pic_center)
渲染效果如下:
链接图片
给图片增加链接,请将图像的Markdown 括在方括号中,然后将链接添加在圆括号中。
[![Girl]( https://i-blog.csdnimg.cn/direct/e5bb27debe7e44d7b119904c4b72d607.png#pic_center "美丽的女孩")](https://www.csdn.net/)
!图片替代文字在图片无法正常显示的情况下发挥作用,说明此图片的内容,正常情况下可为空
转义字符语法
要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 \ 。
\* 我喜欢你
渲染效果如下:
* 我喜欢你
如果没有反斜杠\
,则会是如下效果:
- 我喜欢你
可做转义的字符
下列字符都可以通过使用\
来达到转义字符的目的。