- name
- markdown-canvas
- description
- Convert markdown files to beautiful HTML pages suitable for Canvas display or browser viewing. Use when user asks to render, visualize, display, or share markdown files (.md) in a visual format. Triggers include phrases like "render xxx.md", "canvas display xxx.md", "visualize markdown", "make xxx.md pretty", "share xxx.md as HTML".
- homepage
- https://github.com/jingyu525/markdown-canvas
- metadata
- { "openclaw": { "emoji": "📝", "requires": { "bins": ["python3"] } } }
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:
- Run the conversion script:
python3 scripts/convert.py <path/to/file.md>- Open in browser (if no Canvas node available):
open <output.html>- Or push to Canvas (if node paired):
canvas present file://<output.html>Usage Examples
Basic conversion
# Converts ai-landscape-2026.md → ai-landscape-2026.html
python3 scripts/convert.py ai-landscape-2026.mdCustom output path
python3 scripts/convert.py input.md -o /path/to/output.htmlCustom page title
python3 scripts/convert.py notes.md -t "My Research Notes"Supported Markdown Features
The converter handles:
- Headers (# through ######)
- Bold (
**text**or__text__) - Italic (
*text*or_text_) - Code blocks (``
language ...``) - Inline code (
code) - Links (
[text](url)) - 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
- User requests markdown rendering
- Run
scripts/convert.pyon their file - Script reads
assets/template.html - Script converts markdown → HTML
- Script injects HTML into template
- Output saved alongside source (or custom path)
- 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.