Axi Theme 使用文档

1. Markdown 支持范围#

主题默认启用了常用扩展:

  • GFM:表格、删除线、任务列表等
  • 数学公式:KaTeX($...$ / $$...$$
  • 代码高亮:Shiki(支持标题、差异标注等)

2. 数学公式(KaTeX)#

行内:

欧拉公式:$e^{i\\pi}+1=0$
md

块级:

$$
\\int_0^1 x^2 dx = \\frac{1}{3}
$$
md

3. 代码块增强(差异/高亮)#

你可以在代码中使用注释标记来展示变更(示例来自主题的高亮 transformer):

const a = 1
const a = 2
ts

也可以做行高亮:

const token = 'secret'
ts

4. 什么时候用 MDX#

当你需要在文章里使用组件(例如 AsideTabsGithubCard 等)时,请使用 .mdx,并在文件顶部 import 组件。

组件用法示例文档:见 “MDX 组件使用”。

写作指南:Markdown / MDX
https://theme.axi404.top/blog/writing-markdown-mdx
Author Axi Theme
Published at January 11, 2026