Markdown是什么?
Markdown 是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与 HTML 混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown 被大量使用,如 Github、Wikipedia、简书等,常用的标记符号不超过十个,用于日常写作记录绰绰有余
使用 Markdown 与使用 Word 类编辑器不同。在 Word 之类的应用程序中,单击按钮以设置单词和短语的格式,并且,更改立即可见。而 Markdown 与此不同,当你创建 Markdown 格式的文件时,可以在文本中添加 Markdown 语法,以指示哪些单词和短语看起来应该有所不同。
在线网站
可以使用在线网站同步测试Markdown:在线Markdown编辑器
基础语法
标题语法
要创建标题,需要在单词或短语前面添加井号 (#) 。注意(#)后需要有个空格! # 的数量代表了标题的级别,最多加六个。
| Markdown语法 | HTML | 预览效果 |
|---|---|---|
| # 一级标题 | <h1> 一级标题 </h1> | 一级标题 |
| # 二级标题 | <h2> 二级标题 </h2> | 二级标题 |
| # 三级标题 | <h3> 三级标题 </h3> | 三级标题 |
| # 四级标题 | <h4> 四级标题 </h4> | 四级标题 |
| # 五级标题 | <h5> 五级标题 </h5> | 五级标题 |
| # 六级标题 | <h6> 六级标题 </h6> | 六级标题 |
段落语法
在一行的末尾添加两个或多个英文空格,然后按回车键,即可创建一个换行(<br>)。
如果需要空两格,可以使用全角空格 或者 HTML 实体
| Markdown语法 | HTML | 预览效果 |
|---|---|---|
这是第一段落 这是第二段落 |
<p>这是第一段落<br> 这是第二段落</p> |
这是第一段落 这是第二段落 |
强调语法
粗体(bold)
加粗文本可以使用两个星号 ** 或者两个下划线 __ 包裹待加粗的文本来实现。
| Markdown语法 | HTML | 预览效果 |
|---|---|---|
| 文本**加粗**一下 | 文本<strong>加粗</strong>一下 | 文本加粗一下 |
| bold__加粗__一下 | bold<strong>加粗</strong>一下 | bold加粗一下 |
斜体(Italic)
文本斜体,可以使用一个星号 * 或者一个下划线 _ 包裹待斜体的文本。
| Markdown语法 | HTML | 预览效果 |
|---|---|---|
| 文本是*斜体* | 文本是<em>斜体</em> | 文本是斜体 |
| 文本是_斜体_ | 文本是<em>斜体</em> | 文本是斜体 |
粗体(bold)和斜体(Italic)
可以使用三个星号 *** 或者三个下划线 ___ 包裹待加粗并斜体的文本
| Markdown语法 | HTML | 预览效果 |
|---|---|---|
| 文本***加粗并倾斜*** | 文本<strong><em>加粗并倾斜</em></strong>一下 | 文本加粗并倾斜 |
| 文本___加粗并倾斜___ | 文本<strong><em>加粗并倾斜</em></strong>一下 | 文本加粗并倾斜 |
代码语法
要将单词或短语表示为代码,需要将其包裹在反引号 (`) 中。
| Markdown语法 | HTML | 预览效果 |
|---|---|---|
| Use `code` in markdown | Use <code>code</code> in markdown | Use code in markdown |
转义反引号
如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(``)中。
| Markdown语法 | HTML | 预览效果 |
|---|---|---|
| ``Use `code` in markdown`` | ``Use <code>code</code> in markdown`` | Use `code` in markdown |
分割线语法
创建分割线可以通过三个星号 *** 或者三个短横线 --- 或者三个下划线 ___ 来创建分割线。
MARKDOWN
***
---
___
***
删除线语法
创建删除线可以通过两个波浪线 ~~ 包裹待删除的文本。
MARKDOWN
我要~~删除这个~~文本。
我要删除这个文本。
链接语法
普通链接可以通过 [链接文本](URL) 来创建
MARKDOWN
这是兵仔的blog:[兵仔的blog](https://blog.jwoa.site/)
这是兵仔的blog:兵仔的blog
链接增加title:带有提示的链接
链接 title 是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔。
可以通过 [链接文本](URL "提示文本") 创建
MARKDOWN
[悬停没有提醒的blog](https://blog.jwoa.site)
[鼠标悬停看一下我](https://blog.jwoa.site/ "兵仔在记录生活")
自动链接:网站和Email地址
自动链接是由尖括号 <...> 包裹的绝对 URL 或 Email 地址。它将解析为链接,以 URL 或 Email 作为链接标签。
使用尖括号可以很方便地把 URL 或者 email 地址变成可点击的链接。
MARKDOWN
<https://blog.jwoa.site/>
<fake@example.com>
https://blog.jwoa.site/
fake@example.com
带格式化的链接
超链接可以和加粗强调、代码等元素结构一同使用。
MARKDOWN
<u>这是**兵仔**的blog</u>:[兵仔的blog](https://blog.jwoa.site/)
这是兵仔的blog:兵仔的blog
禁止自动链接
大部分 Markdown 引擎都是默认开启自动链接的,所以当我们想把一个链接渲染为纯文本时,只需要把它变成代码。
MARKDOWN
https://blog.jwoa.site
`https://blog.jwoa.site/`
https://blog.jwoa.sitehttps://blog.jwoa.site/
图片语法
添加图像,需要使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。
[ ]( ) = 文字链接
 = 图片(! 代表 image)
插入图片Markdown语法代码:
MARKDOWN
。
对应的HTML代码:
HTML
<img src="图片链接" alt="图片alt" title="图片title">
MARKDOWN

图1:佐伊小姐
链接图片
图片增加链接,要将图像的 Markdown 括在方括号中,然后将链接添加在圆括号中。 图片Markdown格式: !
MARKDOWN
[](https://blog.jwoa.site/)
参考资料
[1] Markdown基本语法
[2] Markdown 扩展语法


