← 返回文章

在文章里使用语义组件

用 MDX 作为轻量桥梁，演示 Callout、Figure 与 PaperCard。

  • components
  • mdx

普通段落仍然是 Markdown。只有需要表达一个明确的语义单元时，才引入 Astro 组件。

一张带说明的图

内容经由语义层进入 Astro，再输出静态网页的流程图
同一语义模型可以逐步接入 Markdown directive 与 Typst。 · Demo architecture

一张论文卡片

这个 demo 暂时没有为纯 Markdown 引入 directive 解析依赖。后续可以把 :::callout 转换成同一个语义组件，而不用改变文章页、主题或组件 API。