~/blog/markdown-showcase

Markdown 功能演示

文章目录 9 节

这是本站的排版测试页,用来检查文章组件和 Markdown 增强功能在亮色、暗色与移动端的表现。

行内元素与数学公式

支持 加粗、斜体、删除线、行内代码、超链接 和行内公式 E=mc2E = mc^2。

独立公式块使用双美元符号:

∫−∞∞e−x2 dx=π\int_{-\infty}^{\infty} e^{-x^2}\,dx = \sqrt{\pi}

公式由 KaTeX 在构建时渲染,窄屏下长公式可在自身区域横向滚动。

脚注

脚注可以补充来源或说明,不会打断正文阅读1。同一个脚注也可以再次引用1。

提示块

代码块

代码块使用 Shiki 双主题,并支持文件名、行号和元信息高亮;复制按钮只复制源码。

src/lib/format.tsexport function formatDate(date: Date): string {
  const pad = (value: number) => String(value).padStart(2, '0');
  const month = pad(date.getMonth() + 1);
  const day = pad(date.getDate());
  return `${date.getFullYear()}-${month}-${day}`;
}

变更行使用 Shiki 注释标记:

theme.tsconst theme = 'light'; 
const theme = 'dark'; 
const accent = '#a5322a'; 

Mermaid 图表

Mermaid 只在含图表的文章里按需加载,图表会跟随主题切换;源码也可以展开查看。

flowchart LR
  A[写 Markdown] --> B[Astro 构建]
  B --> C[静态 HTML]
  C --> D[GitHub Pages]

表格与任务清单

功能 状态 说明
数学公式 ✅ KaTeX 构建时渲染
代码高亮 ✅ Shiki 双主题
搜索 ✅ Pagefind 静态索引
  • 写 Markdown
  • 本地运行构建
  • 检查最终发布效果

宽表格在手机上会留在自己的可滚动区域,不会撑破正文列。

引用与列表

简单是可靠的先决条件。

—— Edsger W. Dijkstra

  1. 写 Markdown
  2. 构建静态页面
  3. 发布到 GitHub Pages

图片说明与放大

点击图片或用键盘聚焦后按 Enter/Space 可放大;按 Escape 或关闭按钮退出。图片标题会显示为说明文字。

Markdown 图片可带标题,并能在灯箱中查看大图。

折叠块

点开看看

原生 <details> 可用于不必默认展开的补充说明。


每个标题旁的锚点都可以复制章节链接;文章页也提供移动端目录、阅读进度、分享和复制链接。

脚注

  1. 脚注会显示在文章末尾,并带有返回正文的链接。 ↩ ↩2