Markdown 语法参考

warning: 这篇文章距离上次修改已过1196天,其中的内容可能已经有所变动。

Typecho和hexo,都使用 Markdown 作为其内容书写语法。

这是因为相较于富文本语法来说, Markdown 更加简洁,原始文件即使没有引擎解析仍然有很好的易读性。

最重要的是 Markdown 通过简单语法,让人们专注于文字书写。

Markdown 编写的文档后缀为 .md.markdown

下面是一些 Markdown 常用语法。


Markdown logoMarkdown logo


Markdown 标题

Markdown 通过 # + 空格 + 标题内容 的方式,来定义一个标题。

其中#的多少表示这是第几级标题,最多可以有6级。

# 第一级标题
## 第二级标题
### 第三级标题
#### 第四级标题
##### 第五级标题
###### 第六级标题

Markdown 标题效果Markdown 标题效果


Markdown 字体

  • 加粗:在需要 加粗 的内容左右添加**
  • 斜体:在需要 斜体 的内容左右添加*
  • 删除线:在需要 删除线 的内容左右添加~~
  • 斜体加粗:在需要 斜体加粗 的内容左右添加***
**这是需要 加粗 的内容**
*这是需要 斜体 的内容*
~~这是需要 删除线 的内容~~
***这是需要 斜体+加粗 的内容***

Markdown 字体效果Markdown 字体效果


Markdown 引用

Markdown 通过 > + 空格 + 引用内容 的方式,来定义一个引用。

引用可以嵌套,只需要使用多个>即可

> 这是一个引用

>>这是一个嵌套引用

>>>>>>>>>>当然您可以多层嵌套

Markdown 引用效果Markdown 引用效果


Markdown 列表

info:无序列表和有序列表可以混合使用

无序列表

Markdown 通过 - + 空格 + 无序列表内容 的方式,来定义一个无序列表。

通过缩进的方式来确定无序类表等级。

- 无序列表内容
- 无序列表内容
- 无序列表内容

- 第一级无序列表内容
    - 第二级无序列表内容
        - 第三级无序列表内容
            - 第四级无序列表内容

Markdown 无序列表效果Markdown 无序列表效果

有序列表

Markdown 通过 数字 + . + 空格 + 有序列表内容 的方式,来定义一个有序列表。

通过缩进的方式来确定有序类表等级。

1. 有序列表内容
2. 有序列表内容
3. 有序列表内容

1. 第一级有序列表内容
    1. 第二级有序列表内容
    2. 第二级有序列表内容
    3. 第二级有序列表内容
2. 第一级有序列表内容
    1. 第二级有序列表内容
    2. 第二级有序列表内容
    3. 第二级有序列表内容
3. 第一级有序列表内容
    1. 第二级有序列表内容
    2. 第二级有序列表内容
    3. 第二级有序列表内容

Markdown有序列表效果Markdown有序列表效果


Markdown 分割线

Markdown 通过 3个及以上数量连续的*-,来定义一个分割线。

---
----
***
*****

Markdown 分割线效果Markdown 分割线效果


Markdown 超链接

Markdown 通过 [超链接名](超链接地址 "超链接title"),来插入一个超链接。其中 title 可以省略。

[百度](https://www.baidu.com)
[idzd](https://www.idzd.top/ "我的个人博客")

Markdown 超链接效果Markdown 超链接效果


Markdown 图片

Markdown 通过 ![图片说明](图片地址 ''图片title''),来插入一个图片。其中 title 可以省略。

当然,也可以和 超链接 语法混合使用。达到点击图片跳转指定地址效果。

![网站logo](https://www.idzd.top/logo.png "网站logo")

[![点击前往博客首页](https://www.idzd.top/logo.png "点击前往博客首页")](https://www.idzd.top/ "点击前往博客首页")

Markdown 图片效果Markdown 图片效果


Markdown 代码块

  • Markdown 代码块主要有3种风格

    1. 行内代码块,用一个反单引号包裹
    2. 多行代码块(缩进风格),用多个空格缩进来表示
    3. 多行代码块(多语言风格),用3个反单引号包裹,并设置代码语言。
`这是行内代码块`

    这是多行代码块(缩进风格)
    这是多行代码块(缩进风格)
    这是多行代码块(缩进风格)

(```markdown)
这是多行代码块(多语言风格)
这是多行代码块(多语言风格)
这是多行代码块(多语言风格)
(```)

Markdow 代码效果Markdow 代码效果


Markdown 表格

info:一个快速生成Markdown 表格的网站:Tables Generator

详细可以查看此处

Markdown 表格绘制语法如下:

  • 第二行分割表头与内容

    • 默认内容左对齐,当然左侧加也表示左对齐
    • 两边加内容居中
    • 右侧加内容右对齐
  • 原生语法要求用 |包围整个表格。部分解析引擎可以省略。
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

markdown 表格效果,为了美观我的主题锁定了表格对齐方式markdown 表格效果,为了美观我的主题锁定了表格对齐方式


Markdown 流程图

部分Markdown解析引擎或客户端支持此功能。

Markdown 流程图语法Markdown 流程图语法

Markdown 流程图效果Markdown 流程图效果


Markdown 脚注

Markdown 通过 需要脚注的部分 + [^ 脚注内容],来插入一个脚注。

这是脚注[^这里是 **脚注** 的 *内容*.].

这是脚注1.


  1. 这里是 脚注内容.
评论已关闭