本站支持的Markdown语法,供我自己复制用(
1. 标准 Markdown 语法
1.1 多级标题
# H1
## H2
### H3
#### H4
##### H5
###### H61.2 文字样式
**粗体文字**
*斜体文字*
~~删除线~~
==高亮文字== ← mark 插件
++下划线++ ← underline 插件
^上标^ ← sup 插件
~下标~ ← sub 插件
[[Ctrl]] + [[C]] ← kbd 按键插件粗体文字
斜体文字
删除线
高亮文字
下划线
上标
下标
Ctrl + C
后四个是 markdown-it 插件提供的扩展语法,标准 Markdown 不支持。
1.3 代码块
用反引号包裹就可以,`const x = 1`,很方便。效果:用反引号包裹就可以,const x = 1,很方便。
```javascript
function hello(name) {
console.log(`Hello, ${name}!`);
}
```javascript / js、typescript / ts、python / py、go、java、sql、html / xml、css、json、yaml / yml、markdown / md、bash / sh / shell、dockerfile / docker、diff
1.4 列表
- Java
- Python
- Go- Java
- Python
- Go
1. 第一步
2. 第二步
3. 第三步- 第一步
- 第二步
- 第三步
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个待办1.5 引用
> 一级引用内容
> > 二级引用内容
> > **引用内也支持所有 Markdown 语法**
> 回到一级一级引用内容
二级引用内容
引用内也支持所有 Markdown 语法
回到一级
1.6 链接与图片
1.7 表格
表格会自动包在一个横向滚动容器里,手机上看也不用担心撑破屏幕。
| 语言 | 用途 | 难度 |
| ------ | -------- | ---- |
| Go | 后端开发 | 中等 |
| Vue | 前端框架 | 简单 |
| Python | AI/数据 | 简单 || 语言 | 用途 | 难度 |
|---|---|---|
| Go | 后端开发 | 中等 |
| Vue | 前端框架 | 简单 |
| Python | AI/数据 | 简单 |
2. 数学公式(KaTeX)
用 $ 包裹行内公式,用 $$ 包裹独立公式块。
爱因斯坦的质能方程 $E=mc^2$ 是物理学中最著名的公式之一。爱因斯坦的质能方程 是物理学中最著名的公式之一。
$$
\frac{\partial f}{\partial t} = \alpha \nabla^2 f
$$
3. 流程图与图表(Mermaid)
用 mermaid 代码块可以渲染流程图、时序图、类图等。
```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
:::note 类型 标题(可选)
内容(支持任意 Markdown 语法)
:::endnote类型可选:info、success、warning、danger,不写类型默认 default。
:::note info 温馨提示
这是一条**信息提示**,支持 `行内代码` 和 [链接](https://example.com)。
:::endnote:::note warning
注意,这里没写自定义标题,用默认样式。
:::endnote:::note danger 严重警告
删除操作不可恢复,请谨慎操作!
:::endnote4.2 折叠面板 fold
:::fold 标题 [open]
折叠内容(支持任意 Markdown 语法)
:::endfold第二个参数写 open 则默认展开,不写就默认收起。
:::fold 点击展开查看隐藏内容
这是被折叠的内容,支持:
- **粗体**
- `代码`
- 甚至嵌套提示框:
:::note success
折叠里还能嵌套 note!
:::endnote
:::endfold:::fold 默认展开的折叠 open
这个折叠默认是打开状态。
:::endfold这是被折叠的内容,支持:
-
粗体
-
代码 -
甚至嵌套提示框:
折叠里还能嵌套 note!
这个折叠默认是打开状态。
4.3 分栏标签页 tabs
分栏标签页可以把内容分成多个标签切换展示,适合做「源码 / 效果」对比。
语法格式
:::tabs 默认选中标签名
:::tab 标签一
内容一(支持任意 Markdown)
:::endtab
:::tab 标签二
内容二
:::endtab
:::endtabs注意:标签页不支持多层嵌套,不要在
:::tab里面再写:::tabs。
实际效果演示
package main
import "fmt"
func main() {
fmt.Println("Hello, Go!")
}上面那段 Go 代码会被语法高亮,带行号,还能一键复制。
4.4 链接卡片 link
生成一个带图标和描述的外部链接卡片。
:::link 标题, 链接地址, 描述文字:::4.5 视频嵌入 video
支持 B 站、YouTube 和直接视频 URL。
# B站视频
:::video bilibili BV1xx411c7mD:::
# YouTube
:::video youtube 视频ID:::
# 直接视频 URL
:::video https://example.com/video.mp4:::4.6 音频播放 audio
:::audio 标题, 音频URL:::4.7 在线音乐 music
接入 Meting API,支持网易云、QQ 音乐等平台。
# 网易云音乐
:::music netease, 22707008:::
# QQ音乐
:::music qq, 歌曲ID:::4.8 照片墙 photo
多张图片自由排版,自动适应宽度。同一行用空格分隔多张图片,:::n 表示换行。
:::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
评论