Markdown 增强功能演示

Markdown 增强功能演示

2026年1月10日 1 分钟 阅读

表格支持

使用 remark-gfm 插件,支持 GitHub Flavored Markdown 表格:

功能插件说明
表格remark-gfmGitHub 风格表格
Mermaidremark-mermaid流程图、时序图等
数学公式remark-math + rehype-katexLaTeX 数学公式
任务列表remark-gfm待办事项列表

任务列表

  • 安装 remark-gfm
  • 安装 remark-mermaid
  • 安装 remark-math 和 rehype-katex
  • 测试所有功能
  • 编写文档

Mermaid 流程图

graph TD
    A[开始] --> B{是否需要增强?}
    B -->|是| C[安装插件]
    B -->|否| D[使用基础功能]
    C --> E[配置 astro.config.mjs]
    E --> F[重启开发服务器]
    F --> G[完成]
    D --> G

Mermaid 时序图

sequenceDiagram
    participant U as 用户
    participant B as 浏览器
    participant S as 服务器
    
    U->>B: 访问页面
    B->>S: 请求数据
    S-->>B: 返回 Markdown
    B->>B: 解析并渲染
    B-->>U: 显示内容

数学公式

行内公式

这是一个行内公式:E=mc2E = mc^2,爱因斯坦的质能方程。

块级公式

二次方程求根公式:

x=b±b24ac2ax = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}

傅里叶变换:

F(ω)=f(t)eiωtdtF(\omega) = \int_{-\infty}^{\infty} f(t) e^{-i\omega t} dt

矩阵表示:

[abcd][xy]=[ax+bycx+dy]\begin{bmatrix} a & b \\ c & d \end{bmatrix} \begin{bmatrix} x \\ y \end{bmatrix} = \begin{bmatrix} ax + by \\ cx + dy \end{bmatrix}

删除线和强调

使用 remark-gfm 支持:

  • 这是删除线
  • 这是粗体
  • 这是斜体
  • 这是粗斜体

代码高亮

interface User {
  id: number;
  name: string;
  email: string;
}

function greetUser(user: User): string {
  return `Hello, ${user.name}!`;
}

引用

这是一个引用块。

可以包含多行内容。

甚至可以嵌套引用。

链接和图片

总结

通过这些插件,你的 Markdown 文档可以支持:

  1. ✅ GitHub 风格表格
  2. ✅ Mermaid 图表(流程图、时序图、甘特图等)
  3. ✅ LaTeX 数学公式
  4. ✅ 任务列表
  5. ✅ 删除线
  6. ✅ 自动标题锚点
  7. ✅ 代码语法高亮
Ray

© 2026 Ray

GitHub