Markdown Canvas Renderer
Convert markdown files into beautiful, shareable HTML pages with zero external dependencies.
Quick Start
When a user wants to render a markdown file:
- 1. Run the conversion script:
CODEBLOCK0
- 2. Open in browser (if no Canvas node available):
CODEBLOCK1
- 3. Or push to Canvas (if node paired):
CODEBLOCK2
Usage Examples
Basic conversion
CODEBLOCK3
Custom output path
CODEBLOCK4
Custom page title
CODEBLOCK5
Supported Markdown Features
The converter handles:
- - Headers (# through ######)
- Bold (
**text** or __text__) - Italic (
*text* or _text_) - Code blocks (``
language ... `)
- **Inline code** (code)
- **Links** (text)
- **Lists** (unordered: - , , + )
- **Horizontal rules** (---, , )
## Design Philosophy
**Token efficiency**: Template is pre-built; only markdown content flows through the context window.
**Zero dependencies**: Pure Python + self-contained HTML template with embedded CSS.
**Progressive enhancement**: Works offline, no CDN required, renders instantly.
## Workflow
1. User requests markdown rendering
2. Run scripts/convert.py on their file
3. Script reads assets/template.html
4. Script converts markdown → HTML
5. Script injects HTML into template
6. Output saved alongside source (or custom path)
7. Open in browser OR push to Canvas
## Token Cost Analysis
Per conversion:
- Read SKILL.md: ~500 tokens (first time only)
- Execute script: ~100 tokens
- Report result: ~50 tokens
**Total: ~650 tokens** vs ~8000 tokens for generating full HTML each time.
## Output Location
By default, output is saved next to the input file:
- notes.md → notes.html
- /path/to/doc.md → /path/to/doc.html
Use -o` flag to specify custom location.
Markdown Canvas 渲染器
将 Markdown 文件转换为精美、可分享的 HTML 页面，零外部依赖。
快速开始
当用户想要渲染一个 Markdown 文件时：
- 1. 运行转换脚本：
bash
python3 scripts/convert.py
- 2. 在浏览器中打开（如果没有 Canvas 节点可用）：
bash
open
- 3. 或者推送到 Canvas（如果节点已配对）：
bash
canvas present file://
使用示例
基本转换
bash
将 ai-landscape-2026.md 转换为 ai-landscape-2026.html
python3 scripts/convert.py ai-landscape-2026.md
自定义输出路径
bash
python3 scripts/convert.py input.md -o /path/to/output.html
自定义页面标题
bash
python3 scripts/convert.py notes.md -t 我的研究笔记
支持的 Markdown 功能
转换器支持：
- - 标题（# 到 ######）
- 粗体（text 或 text）
- 斜体（text 或 text）
- 代码块（language ... ）
- 行内代码（code）
- 链接（text）
- 列表（无序：- 、 、+ ）
- 水平分割线（---、、）
设计理念
Token 效率：模板预构建；只有 Markdown 内容流经上下文窗口。
零依赖：纯 Python + 自包含的 HTML 模板，内嵌 CSS。
渐进增强：离线可用，无需 CDN，即时渲染。
工作流程
- 1. 用户请求 Markdown 渲染
- 在其文件上运行 scripts/convert.py
- 脚本读取 assets/template.html
- 脚本将 Markdown 转换为 HTML
- 脚本将 HTML 注入模板
- 输出保存在源文件旁（或自定义路径）
- 在浏览器中打开或推送到 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 参数指定自定义位置。
