在 Markdown 排版的基础上,BlogGPT 提供提示块、公式、图表和图片灯箱,也支持在 MDX 中插入交互组件。
Callouts 提示块
自定义标题
用 > [!NOTE]、> [!TIP] 等标记创建提示块,在标记后填写自定义标题。
KaTeX 公式
行内公式 与文字排在同一行,独立公式使用 $$ 包围:
Mermaid 图表
在标记为 mermaid 的代码块中填写图表:
flowchart LR A[编写内容] --> B[本地预览] B --> C[构建站点] C --> D[发布]可以展开查看源码,图表配色会随深浅色外观切换。
PhotoSwipe 图片灯箱
点击图片可以放大查看,在灯箱中缩放、切换图片,或按 Escape 退出。


MDX 交互组件
拖动滑块调整正弦函数的振幅、周期和初始相位,图像会实时更新。也可以用方向键微调,点击“重置”恢复初始值。
正弦函数实验室
y = 1.0 sin(2πx / 6.28 + 0.00)
插入组件
在 .mdx 文件中导入组件,再放入正文:
import SineWave from './SineWave.astro';
<SineWave lang="zh" />这个示例的 SineWave.astro、计算函数与文案都在当前文章的内容包中,lang 设置组件的界面语言。只用于一篇文章的组件放在内容包内,简单结构也可直接写在 MDX 中;多篇文章复用的组件放在 custom/components/,再通过相对路径导入。
按篇配置
各项增强都可以设置全局默认值,并由单篇 frontmatter 覆盖,详见增强开关。
