写文章:代码块与提示框用法

这个主题的文章用 Markdown 写,纯文本 + 代码 + 图片 + callout 基本覆盖技术写作场景。

WARNING
标题与摘要(frontmatter)别偷懒——它们决定首页列表、搜索与分享卡片的效果。

代码块#

主题内置 Expressive Code 代码高亮,带文件名与行号,支持绝大多数语言:

1
// 防抖
2
export function debounce(fn, ms = 300) {
3
  let timer = null;
4
  return (...args) => {
5
    clearTimeout(timer);
6
    timer = setTimeout(() => fn(...args), ms);
7
  };
8
}

1
public class Hello {
2
    public static void main(String[] args) {
3
        System.out.println("Hello, Agent Research.");
4
    }
5
}

TIP
代码高亮是构建期完成的,页面不加载任何高亮脚本——这也是静态博客加载快的原因之一。

提示框(callout)#

用 > [!类型] 写强调块,支持 NOTE / TIP / IMPORTANT / WARNING / CAUTION:

WARNING
示例:这里是一条警告。

图片与更多#

图片放 public/ 或 src/assets/,Markdown 里用相对路径引用
需要数学公式、视频嵌入等进阶能力时,参考主题文档

约定#

能用简单 Markdown 讲清的,别过度设计
代码示例标明运行环境、保证可复现