Markdown Canvas 渲染器

将 Markdown 文件转换为美观、可分享的 HTML 页面，无需任何外部依赖。

快速开始

当用户希望渲染一个 Markdown 文件时：

1. 运行转换脚本：

   python3 scripts/convert.py 
   

2. 在浏览器中打开（若无 Canvas 节点可用）：

   open 
   

3. 或推送至 Canvas（若已配对 Canvas 节点）：

   canvas present file://
   

使用示例

基础转换

# 将 ai-landscape-2026.md 转换为 ai-landscape-2026.html
python3 scripts/convert.py ai-landscape-2026.md

自定义输出路径

python3 scripts/convert.py input.md -o /path/to/output.html

自定义页面标题

python3 scripts/convert.py notes.md -t "My Research Notes"

支持的 Markdown 特性

该转换器支持以下特性：

• 标题（# 至 ######）
• 加粗（**text** 或 __text__）
• 斜体（*text* 或 _text_）
• 代码块（language ... ）
• 行内代码（code）
• 链接（[text](url)）
• 列表（无序列表： - 、* 、+ ）
• 水平分割线（---、***、___）

设计哲学

Token 效率优先：模板预先构建完成；仅 Markdown 内容流经上下文窗口。

零依赖：纯 Python 实现 + 自包含 HTML 模板（含内联 CSS）。

渐进增强：支持离线运行，无需 CDN，即时渲染。

工作流程

1. 用户发起 Markdown 渲染请求
2. 在其文件上运行 scripts/convert.py
3. 脚本读取 assets/template.html
4. 脚本将 Markdown 转换为 HTML
5. 脚本将生成的 HTML 注入模板
6. 输出文件保存在源文件同目录下（或按自定义路径保存）
7. 在浏览器中打开，或推送至 Canvas

Token 消耗分析

每次转换消耗：

• 读取 SKILL.md：约 500 tokens（仅首次）
• 执行脚本：约 100 tokens
• 返回结果报告：约 50 tokens

总计：约 650 tokens，相较每次生成完整 HTML 所需的约 8000 tokens 显著降低。

输出位置

默认情况下，输出文件与输入文件位于同一目录：

• notes.md → notes.html
• /path/to/doc.md → /path/to/doc.html

使用 -o 参数可指定自定义输出路径。