🤣🤣

本站支持的Markdown语法,供我自己复制用(


1. 标准 Markdown 语法

1.1 多级标题

MARKDOWN
# H1
## H2
### H3
#### H4
##### H5
###### H6

1.2 文字样式

MARKDOWN
**粗体文字**
*斜体文字*
~~删除线~~
==高亮文字==          ← mark 插件
++下划线++          ← underline 插件
^上标^             ← sup 插件
~下标~             ← sub 插件
[[Ctrl]] + [[C]]   ← kbd 按键插件

粗体文字
斜体文字
删除线
高亮文字
下划线
上标
下标
Ctrl + C

后四个是 markdown-it 插件提供的扩展语法,标准 Markdown 不支持。


1.3 代码块

MARKDOWN
用反引号包裹就可以,`const x = 1`,很方便。

效果:用反引号包裹就可以,const x = 1,很方便。

MARKDOWN
```javascript
function hello(name) {
  console.log(`Hello, ${name}!`);
}
```

javascript / jstypescript / tspython / pygojavasqlhtml / xmlcssjsonyaml / ymlmarkdown / mdbash / sh / shelldockerfile / dockerdiff


1.4 列表

MARKDOWN
- Java
- Python
- Go
  • Java
  • Python
  • Go
MARKDOWN
1. 第一步
2. 第二步
3. 第三步
  1. 第一步
  2. 第二步
  3. 第三步
MARKDOWN
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个待办

1.5 引用

MARKDOWN
> 一级引用内容
> > 二级引用内容
> > **引用内也支持所有 Markdown 语法**
> 回到一级

一级引用内容

二级引用内容
引用内也支持所有 Markdown 语法
回到一级


1.6 链接与图片

MARKDOWN
[普通链接](https://github.com)
[带标题的链接](https://github.com "GitHub 首页")

普通链接
带标题的链接

MARKDOWN
![替代文本](https://placehold.co/600x200/3b82f6/white?text=示例图片)

替代文本


1.7 表格

表格会自动包在一个横向滚动容器里,手机上看也不用担心撑破屏幕。

MARKDOWN
| 语言   | 用途     | 难度 |
| ------ | -------- | ---- |
| Go     | 后端开发 | 中等 |
| Vue    | 前端框架 | 简单 |
| Python | AI/数据  | 简单 |
语言 用途 难度
Go 后端开发 中等
Vue 前端框架 简单
Python AI/数据 简单

2. 数学公式(KaTeX)

$ 包裹行内公式,用 $$ 包裹独立公式块。

MARKDOWN
爱因斯坦的质能方程 $E=mc^2$ 是物理学中最著名的公式之一。

爱因斯坦的质能方程 E=mc2E=mc^2 是物理学中最著名的公式之一。

MARKDOWN
$$
\frac{\partial f}{\partial t} = \alpha \nabla^2 f
$$

ft=α2f\frac{\partial f}{\partial t} = \alpha \nabla^2 f


3. 流程图与图表(Mermaid)

mermaid 代码块可以渲染流程图、时序图、类图等。

点击展开
MARKDOWN
```mermaid
graph TD
    A[开始] --> B{是否登录?}
    B -->|是| C[进入首页]
    B -->|否| D[跳转登录页]
    C --> E[浏览文章]
    D --> E
```

实际渲染效果:

graph TD
    A[开始] --> B{是否登录?}
    B -->|是| C[进入首页]
    B -->|否| D[跳转登录页]
    C --> E[浏览文章]
    D --> E

4. 自定义扩展块

本站用 ::: 语法做扩展块,比 Hexo 的 {% %} 写起来快多了。

4.1 提示框 note

MARKDOWN
:::note 类型 标题(可选)
内容(支持任意 Markdown 语法)
:::endnote

类型可选:infosuccesswarningdanger,不写类型默认 default

TEXT
:::note info 温馨提示
这是一条**信息提示**,支持 `行内代码` 和 [链接](https://example.com)。
:::endnote
TEXT
:::note warning
注意,这里没写自定义标题,用默认样式。
:::endnote
TEXT
:::note danger 严重警告
删除操作不可恢复,请谨慎操作!
:::endnote
温馨提示

这是一条信息提示,支持 行内代码链接

注意,这里没写自定义标题,用默认样式。

严重警告

删除操作不可恢复,请谨慎操作!


4.2 折叠面板 fold

MARKDOWN
:::fold 标题 [open]
折叠内容(支持任意 Markdown 语法)
:::endfold

第二个参数写 open 则默认展开,不写就默认收起。

TEXT
:::fold 默认展开的折叠 open
这个折叠默认是打开状态。
:::endfold
点击展开查看隐藏内容

这是被折叠的内容,支持:

  • 粗体

  • 代码

  • 甚至嵌套提示框:

    折叠里还能嵌套 note!

默认展开的折叠

这个折叠默认是打开状态。


4.3 分栏标签页 tabs

分栏标签页可以把内容分成多个标签切换展示,适合做「源码 / 效果」对比。

语法格式

MARKDOWN
:::tabs 默认选中标签名
:::tab 标签一
内容一(支持任意 Markdown)
:::endtab
:::tab 标签二
内容二
:::endtab
:::endtabs

注意:标签页不支持多层嵌套,不要在 :::tab 里面再写 :::tabs

实际效果演示

GO
package main

import "fmt"

func main() {
    fmt.Println("Hello, Go!")
}

上面那段 Go 代码会被语法高亮,带行号,还能一键复制。


生成一个带图标和描述的外部链接卡片。

MARKDOWN
:::link 标题, 链接地址, 描述文字:::

4.5 视频嵌入 video

支持 B 站、YouTube 和直接视频 URL。

MARKDOWN
# B站视频
:::video bilibili BV1xx411c7mD:::

# YouTube
:::video youtube 视频ID:::

# 直接视频 URL
:::video https://example.com/video.mp4:::

4.6 音频播放 audio

MARKDOWN
:::audio 标题, 音频URL:::
播放音频
示例音频
0:00 / 0:00

4.7 在线音乐 music

接入 Meting API,支持网易云、QQ 音乐等平台。

MARKDOWN
# 网易云音乐
:::music netease, 22707008:::

# QQ音乐
:::music qq, 歌曲ID:::
播放在线音乐
加载中...
0:00 / 0:00

4.8 照片墙 photo

多张图片自由排版,自动适应宽度。同一行用空格分隔多张图片,:::n 表示换行。

TEXT
:::photo
https://placehold.co/300x200/3b82f6/white?text=A https://placehold.co/300x200/10b981/white?text=B
:::n
https://placehold.co/600x200/f59e0b/white?text=C
:::endphoto
图片
图片
图片

评论