Markdown学习笔记

最新推荐文章于 2025-06-21 10:02:17 发布

原创最新推荐文章于 2025-06-21 10:02:17 发布 · 5.7k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#markdown

这篇博客详细介绍了Markdown的使用，包括标题、注释、字体、分隔线、删除线、下划线、脚注、列表、区块、代码、链接、图片、表格、数学公式、高级技巧等。此外，还提到了Markdown在HEXO博客中的配置，如标签页、分类页以及Markdown编辑器的新功能，如快捷键、焦点模式和甘特图等。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Markdown标题

1-6级标题代码：

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

输出效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

Markdown注释

[comment]: <> (This is a comment, it will not be included)

[//]: <> (This is also a comment.)

[^_^]:
commentted-out contents
should be shift to right by four spaces (`>>`).

Markdown 段落

段落的换行是使用两个以上空格加上回车

字体

*斜体1* 
_斜体2_
**加粗1** 
__加粗2__
***加粗斜体1*** 
___加粗斜体2___

输出效果：
斜体1
斜体2
加粗1
加粗2
加粗斜体1
加粗斜体2

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：
***
* * *
*****
- - -
-----
输出效果：

删除线

~~HEXO~~

输出效果：
~~HEXO~~

下划线

<u>HEXO</u>

输出效果：
HEXO

脚注

脚注[^1]
[^1]: 这里是脚注

脚注¹

Markdown列表

* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项

- 第一项
- 第二项
- 第三项

输出效果：

第一项
第二项
第三项

第一项
第二项
第三项

第一项
第二项
第三项

列表嵌套

列表嵌套只需在子列表中的选项前面添加四个空格即可

1. 第一项：
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项：
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素

第一项：
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
第二项：
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素

Markdown区块

Markdown 区块引用是在段落开头使用 > 符号，然后后面紧跟一个空格符号：
> 最外层
> > 第一层嵌套
> > > 第二层嵌套

输出效果：

最外层

第一层嵌套

第二层嵌套

Markdown代码：

`printf()`

输出效果：
printf()

附带语言

```py
print("Hello")
```

输出效果：

print("Hello")

代码区块

代码区块使用 4 个空格或者一个制表符（Tab 键）。

代码区块

Markdown链接

[链接名称](链接地址)  

<链接地址>

我的个人博客链接：Blog

http://yuanty.gitee.io/blog/

Markdown图片：

Markdown 图片语法格式如下：

![alt 属性文本](图片地址)  

![alt 属性文本](图片地址 "可选标题")

应用实例：

RUNOOB 图标

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-0shMskOb-1609937718054)(http://static.runoob.com/images/runoob-logo.png “RUNOOB”)]

附上md语法速记图片：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Bm1iRxGS-1609937718056)(Markdown-Note/md_note.png)]

Markdown表格

Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。

我们可以设置表格的对齐方式：
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。

语法格式如下：

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 1     | 2     | 3      |
| 4     | 5     | 6      |

输出效果：

左对齐	右对齐	居中对齐
1	2	3
4	5	6

Markdown数学公式

markdown数学公式语法

Markdown 高级技巧

支持的 HTML 元素

不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。

目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等 ，如：
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

使用 Ctrl+Alt+Del 重启电脑

转义

\*\* 正常显示星号 \*\*

** 正常显示星号 **

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

流程图

```mermaid

flowchat
st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st->op->cond
cond(yes)->io->e
cond(no)->sub1(right)->op
```

```mermaid

flowchat
st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st(right)->op(right)->cond
cond(yes)->io(bottom)->e
cond(no)->sub1(right)->op
```

HEXO_Markdown页面配置

Front-matter 是档案最上方以 — 分隔的区域，用于指定个别档案的变数。

---
title:
date:
updated:
type:
comments:
description:
keywords:
top_img:
mathjax:
katex:
aside:
aplayer：
highlight_shrink：
---

写法	解释
title	【必需】页面标题
date	【必需】页面创建日期
type	【必需】标签、分类和友情链接三个页面需要配置
updated	【可选】页面更新日期
description	【可选】页面描述
keywords	【可选】页面关键字
comments	【可选】显示页面评论模块(默认 true)
top_img	【可选】页面顶部图片
mathjax	【可选】显示mathjax(当设置mathjax的per_page: false时，才需要配置，默认 false)
katex	【可选】显示katex(当设置katex的per_page: false时，才需要配置，默认 false)
aside	【可选】显示侧边栏 (默认 true)
aplayer	【可选】在需要的页面加载aplayer的js和css,请参考文章下面的音乐配置
highlight_shrink	【可选】配置代码框是否展开(true/false)(默认为设置中

标签页

前往博客根目录
输入hexo new page tags
找到source/tags/index.md

分类页

前往博客根目录
输入hexo new page categories
找到source/categories/index.md

欢迎使用Markdown编辑器

你好！这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：

全新的界面设计 ，将会带来全新的写作体验；
在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
全新的 KaTeX数学公式 语法；
增加了支持甘特图的mermaid语法¹ 功能；
增加了 多屏幕编辑 Markdown文章功能；
增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
增加了 检查列表 功能。

功能快捷键

撤销：Ctrl/Command + Z
重做：Ctrl/Command + Y
加粗：Ctrl/Command + B
斜体：Ctrl/Command + I
标题：Ctrl/Command + Shift + H
无序列表：Ctrl/Command + Shift + U
有序列表：Ctrl/Command + Shift + O
检查列表：Ctrl/Command + Shift + C
插入代码：Ctrl/Command + Shift + K
插入链接：Ctrl/Command + Shift + L
插入图片：Ctrl/Command + Shift + G
查找：Ctrl/Command + F
替换：Ctrl/Command + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。
输入2次#，并按下space后，将生成2级标题。
以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

~~删除文本~~

引用文本

H₂O is是液体。

2¹⁰ 运算结果是 1024.

插入链接与图片

链接: link.

图片: Alt

带尺寸的图片:

居中的图片: Alt

居中并且带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

项目
- 项目
  - 项目

项目1
项目2
项目3

计划任务
完成任务

创建一个表格

一个简单的表格是这么创建的：

项目	Value
电脑	$1600
手机	$12
导管	$1

设定内容居中、居左、居右

使用:---------:居中
使用:----------居左
使用----------:居右

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

SmartyPants

SmartyPants将ASCII标点字符转换为“智能”印刷标点HTML实体。例如：

TYPE	ASCII	HTML
Single backticks	`'Isn't this fun?'`	‘Isn’t this fun?’
Quotes	`"Isn't this fun?"`	“Isn’t this fun?”
Dashes	`-- is en-dash, --- is em-dash`	– is en-dash, — is em-dash