presenterm 用于在终端里构建和播放基于 Markdown 的演示文稿。幻灯片正文就是普通 Markdown（标题、列表、表格、围栏代码、引用），只需额外了解其扩展语法。
幻灯片结构：用单独一行的 --- 分隔幻灯片；第一个 # 是幻灯片标题，紧随其后的 ## 在标题页中作为副标题。演讲者备注写在 HTML 注释中，仅在演示模式可见。
代码块属性：在围栏语言标签后追加。+exec 在幻灯片显示时按 e 键运行，输出显示在下方；+exec_replace 在加载幻灯片时自动运行并用输出替换代码块；+render 将代码块渲染为图片（mermaid、d2、latex、typst）；+width:80% 设置渲染图片尺寸。执行需在启动时显式开启：presenterm -x file.md 启用 +exec，presenterm -X file.md 启用 +exec_replace，presenterm --validate-snippets file.md 只做类型检查不运行。
图表与公式渲染：对 mermaid、d2、latex、typst 代码块使用 +render 会在加载时转为图片。缺少渲染器会静默失败，需按需安装：mermaid 用 @mermaid-js/mermaid-cli（npm），d2 用 d2，typst 用 typst，latex 用 typst 和 pandoc（pandoc 把 LaTeX 转为 typst，typst 再栅格化）。可在 config.yaml 中调整输出参数。
运行与导出：presenterm file.md；presenterm -t catppuccin file.md（--list-themes 查看全部主题）；presenterm --export-pdf file.md；presenterm -c /path/to/config.yaml file.md。图片需要终端协议，--image-protocol auto 为默认值；在 SSH 或多路复用器中自动检测不准时可强制指定 iterm2、kitty-local、kitty-remote、sixel、ascii-blocks（回退）。
配置位置：Linux 为 ~/.config/presenterm/config.yaml，macOS 为 ~/Library/Application Support/presenterm/config.yaml，可设置 theme、image_protocol、validate_overflows、enable_snippet_execution 等。
演示按键：←/→ 或 Space/Backspace 导航；g 跳转到指定幻灯片编号；e 执行 +exec 代码块；f 全屏；? 帮助；q 退出。
限制：代码执行默认关闭，需启动参数开启；渲染依赖外部工具，缺失时静默失败；图片显示依赖终端协议，在 SSH 或多路复用器下可能需要手动指定。