~/blog/markdown-showcase
Markdown 功能演示
这是本站的排版测试页,用来检查文章组件和 Markdown 增强功能在亮色、暗色与移动端的表现。
行内元素与数学公式
支持 加粗、斜体、删除线、行内代码、超链接 和行内公式 。
独立公式块使用双美元符号:
公式由 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
- 写 Markdown
- 构建静态页面
- 发布到 GitHub Pages
图片说明与放大
点击图片或用键盘聚焦后按 Enter/Space 可放大;按 Escape 或关闭按钮退出。图片标题会显示为说明文字。
折叠块
点开看看
原生 <details> 可用于不必默认展开的补充说明。
每个标题旁的锚点都可以复制章节链接;文章页也提供移动端目录、阅读进度、分享和复制链接。