语法兼容性测试

这一页把 MkDocs Material + pymdownx 常用的语法全过一遍，验证 Zensical 是否原样兼容。

1. 选项卡 ===（pymdownx.tabbed）

import pandas as pd
df = pd.read_csv("data.csv")

library(readr)
df <- read_csv("data.csv")

SELECT * FROM data;

2. 提示框 !!!（admonition）

3. 可折叠块 ???（pymdownx.details）

SELECT * FROM table WHERE id = 1;

折叠块里嵌套选项卡

print("hello")

cat("hello")

4. 代码注解 # (1)（content.code.annotate）

with open('file.sql') as f:  # (1)
    sql = f.read()
params = {"game_cd": 1041}  # (2)

1. 说明第一处标注 —— 打开 SQL 文件并读取内容。
2. 说明第二处标注 —— 传入游戏 ID 参数。

非代码场景下用 { .annotate }：

工作时间 9:30-18:30 (1)

1. 最多可提前 30 分钟下班。

5. 代码行高亮 hl_lines（pymdownx.highlight）

import pandas as pd
from jinja2 import Template
import os, time
os.chdir(os.path.dirname(os.path.abspath(__file__)))
os.environ['TZ'] = 'Asia/Shanghai'

连续行用 -：

def main():
    a = 1
    b = 2
    c = a + b
    return c

6. Mermaid 图表（pymdownx.superfences）

流程图：

graph TD
    A[数据采集] --> B{数据类型}
    B -->|结构化| C[写入数据库]
    B -->|非结构化| D[文本处理]

时序图：

sequenceDiagram
    participant 用户
    participant 服务端
    用户->>服务端: 发起请求
    服务端-->>用户: 响应数据

7. 脚注 [^1]（footnotes）

文件最大只能 20MB¹，单条消息长度有限制²。

8. 内联代码与链接

行内 code 高亮、{==高亮文本==}（critic 扩展，本项目未开启，预期不渲染）。

普通链接 Zensical 与自动链接 https://zensical.org/。