Markdown 基本语法

介绍

Markdown是一种轻量级标记语言，排版语法简洁，让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档，可与HTML混编，可导出
HTML、PDF 以及本身的 .md
格式的文件。因简洁、高效、易读、易写，Markdown被大量使用，如Github、Wikipedia、简书等。

在线体验一下

Markdown在线编辑器

Markdown 标题语法

要创建标题，请在单词或短语前面添加井号 (#) 。#
的数量代表了标题的级别。例如，添加三个 # 表示创建一个三级标题 (

) (例如：### My Header)。

Markdown语法

HTML

预览效果
# Heading level 1<h1>Heading level 1</h1>
Heading level 1
## Heading level 2<h2>Heading level 2</h2>
Heading level 2
### Heading level 3<h3>Heading level 3</h3>
Heading level 3
#### Heading level 4<h4>Heading level 4</h4>
Heading level 4
##### Heading level 5<h5>Heading level 5</h5>
Heading level 5
###### Heading level 6<h6>Heading level 6</h6>
Heading level 6
最佳实践
不同的 Markdown 应用程序处理 #
和标题之间的空格方式并不一致。为了兼容考虑，请用一个空格在 #
和标题之间进行分隔。

✅ Do this

❌ Don’t do this
# Here’s a Heading #Here’s a Heading

Markdown 强调语法

粗体（Bold）

要加粗文本，请在单词或短语的前后各添加两个星号（asterisks）或下划线（underscores）。如需加粗一个单词或短语的中间部分用以表示强调的话，请在要加粗部分的两侧各添加两个星号（asterisks）。

Markdown语法HTML预览效果
I just love bold
text.I just love bold
text.I just love bold text.
I just love bold
text.I just love bold
text.I just love bold text.
LoveisboldLoveisboldLoveisbold

粗体（Bold）用法最佳实践

Markdown
应用程序在如何处理单词或短语中间的下划线上并不一致。为兼容考虑，在单词或短语中间部分加粗的话，请使用星号（asterisks）。

✅  Do this❌  Don’t do this
LoveisboldLove__is__bold

斜体（Italic）

要用斜体显示文本，请在单词或短语前后添加一个星号（asterisk）或下划线（underscore）。要斜体突出单词的中间部分，请在字母前后各添加一个星号，中间不要带空格。

粗体（Bold）和斜体（Italic）

要同时用粗体和斜体突出显示文本，请在单词或短语的前后各添加三个星号或下划线。要加粗并用斜体显示单词或短语的中间部分，请在要突出显示的部分前后各添加三个星号，中间不要带空格。

Markdown 分隔线语法 要创建分隔线，请在单独一行上使用三个或多个星号

(***)、破折号 (—) 或下划线 (___) ，并且不能包含其他内容。 ```other

分隔线（Horizontal Rule）用法最佳实践

为了兼容性，请在分隔线的前后均添加空白行。

✅  Do this❌  Don't do this
Try to put a blank line before...

---

...and after a horizontal rule.		Without blank lines, this would be a heading.
---
Don't do this!

Markdown 链接语法

链接文本放在中括号内，链接地址放在后面的括号中，链接title可选。
超链接Markdown语法代码：超链接显示名
对应的HTML代码：超链接显示名

1
2
3
这是一个链接 [Markdown语法](<https://markdown.com.cn>)。
例子：茗辰原博客：[茗辰原博客](<https://mcy.cloudns.org>)

渲染效果如下: 茗辰原博客：茗辰原博客 ### 给链接增加 Title
链接title是当鼠标悬停在链接上时会出现的文字，这个title是可选的，它放在圆括号中链接地址后面，跟链接地址之间以空格分隔

1
2
3
这是一个链接 [Markdown语法](<https://markdown.com.cn> "最好的markdown教程")。
例子：[茗辰原博客](<https://mcy.cloudns.org>"茗辰原，一个与众不同的异世界，等待你的探索与发现。")

渲染效果如下: 这是一个博客 茗辰原博客。

网址和Email地址

使用尖括号可以很方便地把URL或者email地址变成可点击的链接。

1
2
3
<https://mcy.cloudns.org/>
<mcy070329@qq.com>

渲染效果如下: https://mcy.cloudns.org/ mcy070329@qq.com #
Markdown 图片语法 要添加图像，请使用感叹号 (!),
然后在方括号增加替代文本，图片链接放在圆括号里，括号里的链接后可以增加一个可选的图片标题文本。

1
2
3
4
5
插入图片Markdown语法代码：![图片alt](图片链接 "图片title")。

对应的HTML代码：<img src="图片链接" alt="<https://i.miji.bid/2024/01/21/7c3fc69882826586bda6a94671dbfded.th.png>"
title="mcy">

1
2
![这是图片](<https://i.miji.bid/2024/01/21/7c3fc69882826586bda6a94671dbfded.th.png"茗辰原头像">)