Markdown 排版速查:这个博客支持的写作元素
2026 年 10 月 08 日3 分钟587 字
这篇文章集中展示博客支持的 Markdown 元素,方便写作时参考。
标题层级
从二级标题到六级标题,都会自动生成目录锚点。
三级标题示例
四级标题示例
段落与强调
这是一段普通的正文。可以使用 粗体、斜体、删除线 和 行内代码。
这是一段引用文字。引用会带有左侧的绿色边框和淡绿色背景,适合用来放名言或重点内容。
列表
无序列表:
- 第一项
- 第二项
- 嵌套项 A
- 嵌套项 B
- 第三项
有序列表:
- 第一步:准备材料
- 第二步:开始制作
- 第三步:享用成品
任务列表:
- 已完成的任务
- 待完成的任务
- 另一个待办
代码块
支持语法高亮的代码块:
function greeting(name) {
return `你好,${name}!欢迎来到手帐博客。`;
}
console.log(greeting("旅人"));
.paper-card {
background: white;
border-radius: 1rem;
transition: all 0.3s ease;
}
表格
| 功能 | 支持 | 说明 |
|---|---|---|
| 标题 | ✅ | h1-h6 |
| 列表 | ✅ | 有序/无序/任务 |
| 代码 | ✅ | 语法高亮 |
| 表格 | ✅ | GFM 表格 |
| 数学公式 | ❌ | 暂未支持 |
链接与图片
这是一个 普通链接 的示例。
图片会自动带有圆角和阴影:
图片网格
使用 :::grid{cols=N} 容器可以把连续图片排成网格,N 支持 1-4(默认 2),窄屏时自动降为 2 列:
两列网格的效果:
分割线
上面是图片,下面是分割线。
代码块文件名与折叠
冒号后写文件路径即可在顶部展示文件名;超过 10 行的代码块默认折叠:
export function quickSort(arr: number[]): number[] {
if (arr.length <= 1) return arr;
const [pivot, ...rest] = arr;
const left = rest.filter((n) => n < pivot);
const right = rest.filter((n) => n >= pivot);
return [...quickSort(left), pivot, ...quickSort(right)];
}
export function fibonacci(n: number): number {
if (n <= 1) return n;
let prev = 0;
let curr = 1;
for (let i = 2; i <= n; i++) {
[prev, curr] = [curr, prev + curr];
}
return curr;
}
export function chunk<T>(arr: T[], size: number): T[][] {
const result: T[][] = [];
for (let i = 0; i < arr.length; i += size) {
result.push(arr.slice(i, i + size));
}
return result;
}
以上就是常用的排版元素啦,祝你写作愉快!
如果这篇文章对你有帮助,请作者喝杯咖啡 ☕