HiCode
返回首页
写作

Markdown 排版速查:这个博客支持的写作元素

2026 年 10 月 08 日3 分钟587 字

这篇文章集中展示博客支持的 Markdown 元素,方便写作时参考。

标题层级

从二级标题到六级标题,都会自动生成目录锚点。

三级标题示例

四级标题示例

段落与强调

这是一段普通的正文。可以使用 粗体、斜体、删除线 和 行内代码。

这是一段引用文字。引用会带有左侧的绿色边框和淡绿色背景,适合用来放名言或重点内容。

列表

无序列表:

  • 第一项
  • 第二项
    • 嵌套项 A
    • 嵌套项 B
  • 第三项

有序列表:

  1. 第一步:准备材料
  2. 第二步:开始制作
  3. 第三步:享用成品

任务列表:

  • 已完成的任务
  • 待完成的任务
  • 另一个待办

代码块

支持语法高亮的代码块:

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;
}

以上就是常用的排版元素啦,祝你写作愉快!

如果这篇文章对你有帮助,请作者喝杯咖啡 ☕