mermaid 和 SVG¶

mermaid¶

直接写 ```mermaid 代码块 (不要写 ```{mermaid})。myst_fence_as_directive = ["mermaid"] 让同一个代码块在 PyCharm / GitHub 预览里能显示, 在 Sphinx 构建时也能被 sphinxcontrib-mermaid 渲染。

        flowchart LR
    A[写 README.md] --> B[git push]
    B --> C[GitHub Actions]
    C --> D[sphinx-build]
    D --> E[Cloudflare Pages]
    E --> F[浏览器]
    E --> G[AI agent]

时序图¶

        sequenceDiagram
    participant Agent
    participant KB as kb.sanhe.me
    Agent->>KB: GET /llms.txt
    KB-->>Agent: 文档列表 (源文件链接)
    Agent->>KB: GET /p/<doc_id>.md
    KB-->>Agent: 302 到 /_sources/.../README.md

SVG 文件¶

SVG 文件和文档放在同一个文件夹里, 用普通的 Markdown 图片语法引用, GitHub 上也能显示:

architecture

内联 SVG¶

SVG 代码直接写在 Markdown 里, 作为 raw HTML 原样输出: