Markdown - 基本语法

基本语法

标题

要创建标题的话只需使用井号 # 开头,井号的数量对应标题的级别。比如如果你想要创建一个 <h3> 则可以通过用三个 # 来代替。

1
### 标题内容

注意事项:

  • 标题的井号后面务必要记得加上一个空格。
  • 段落之间的 ATX 标题最好使用空行分隔。因为有的 Markdown 引擎不识别缺少前后空行的标题。

段落

直接使用空行分隔文本即可。

1
这是一个普通段落

这是一个普通段落

注意事项:

  • 段落开头不要使用空格或者制表符(\t 即 Tab 键)来缩进,否则可能会被当做代码块渲染。
  • 中文传统排版上段落开头有着“空两格”的习惯,可以使用全角空格或者 HTML 实体 &emsp;

加粗和斜体

加粗

要加粗文本可以使用两个星号 ** 或者两个下划线 __ 包裹待加粗的文本来实现。

1
2
把文本 **加粗** 一下
把文本 __加粗__ 一下

把文本 加粗 一下
把文本 加粗 一下

注意事项:
加粗用星号和用下划线的不同之处在于星号用法前后可以不加空格,但下划线必须要加。

1
2
把文本**加粗**一下
把文本__加粗__一下

把文本加粗一下
把文本__加粗__一下

斜体

要使文本斜体,可以使用一个星号 * 或者一个下划线 _ 包裹待斜体的文本。

1
2
这两个字是 *斜体* 着的
这两个字是 _斜体_ 着的

这两个字是 斜体 着的
这两个字是 斜体 着的

注意事项:
和加粗类似,星号用法前后可以不加空格,但下划线必须要加。

加粗并斜体

如果你需要加粗的同时使文本斜体,可以使用三个星号 *** 或者三个下划线 ___ 包裹待斜体的文本。

1
2
同时 ***加粗并斜体*** 的示例
同时 ___加粗并斜体___ 的示例

同时 加粗并斜体 的示例
同时 加粗并斜体 的示例

分割线

通过大于等于三个星号 *** 、短横线 — 或者下划线 ___ 来创建分隔线。

1
2
3
***
---
___



删除线

可以通过删除线划掉文本,创建删除线可以通过一个 ~ 或两个波浪线 ~~ 包裹待删除的文本。

1
~~我觉得我很帅!~~ 因为我是普信男。

我觉得我很帅! 因为我是普信男。

超链接

通过 [链接文本](URL) 来创建超链接。

普通超链接

1
推荐阅读:[Markdown 教程](https://www.runoob.com/markdown/md-tutorial.html)

推荐阅读:Markdown 教程

带有提示标题的超链接

1
推荐阅读:[Markdown 教程](https://www.runoob.com/markdown/md-tutorial.html "菜鸟教程")

推荐阅读:Markdown 教程

禁止链接

大部分 Markdown 引擎都是默认开启自动链接的,所以当我们想把一个链接渲染为纯文本时,需要把它变成代码。

1
`https://www.xukaiyyds.cn`

https://www.xukaiyyds.cn

图片

使用感叹号 ! 后跟超链接就可以渲染图片了。

1
![Logo](https://www.xukaiyyds.cn/img/favicon.png)

Logo

转义字符

几乎所有 ASCII 标点符号都可以使用反斜杠 \ 进行转义。

1
\\(反斜杠)\`(反引号)\*(星号)\_(下划线)\{}(花括号)\[](方括号)\()圆括号

\(反斜杠)`(反引号)*(星号)_(下划线){}(花括号)[](方括号)()圆括号

嵌入 HTML

这在需要设置图片大小、字体颜色时会比较有用,但我并不建议过多使用 HTML 来进行排版,一来是因为这样做实际上并不通用,因为有的 Markdown 引擎因为安全原因会过滤部分标签或者属性;二来是因为这样做太不 Markdown 了!

1
**Markdown**<em>HTML</em> 混合排版

MarkdownHTML 混合排版

另外,请勿在 HTML 中嵌入 Markdown,这样的话它并不会工作。

1
<p>**粗体**不会生效</p>

**粗体**不会生效

语法规范

Markdown 语法规范目前尚未形成标准,如下列出的几种语法规范较为主流,其中 CommonMark 和 GFM 是目前最有可能进行标准化的,GFM 是 GitHub 基于 CommonMark 进行的扩展,它几乎已经是事实标准了。

版权声明

本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 协议 ,转载请注明出处!


Markdown - 基本语法
https://www.xukaiyyds.cn/posts/6dd28e9b/
作者
xukai
发布于
2022年4月20日
更新于
2023年3月31日
许可协议