Tapestry Export

Export knowledge base content to portable file formats: $ARGUMENTS

When to use this skill

Use this skill when:

• A user wants to export, save, download, or share knowledge base content
• The user asks for a PDF, Markdown, or HTML version of a document or the whole KB
• The user wants offline-readable files from the knowledge base
• The user wants to share a chapter or article outside the viewer

Arguments

The argument string may contain any combination of:

• format: pdf, markdown, html, or all (default: all)
• scope: file, note, feed, or kb (default: kb)
• target: a path or partial path to the target artifact (required for file, note, feed scopes)

Examples:

• "pdf kb" — export the entire knowledge base as PDF
• "html file _data/books/ai/chapter.md" — export one document as HTML
• "all note _data/notes/2025/03/my-note.md" — export one note in all three formats
• "markdown feed _data/feeds/2025/03/abc123.json" — export one feed entry as Markdown

Scope Resolution

Scope	Source files	Notes
file	Single .md file under _data/books/	Path provided by user
note	Single .md file under _data/notes/	Path provided by user
feed	Single .json file under _data/feeds/	Exports the body field as Markdown
kb	All .md files under _data/books/ recursively	Entire knowledge base

Workflow

1. Parse the argument to determine format, scope, and target.
2. Change to the project root directory.
3. Run the export script:

# Export entire KB as PDF
python export/_scripts/export.py --format pdf --scope kb

# Export entire KB in all formats
python export/_scripts/export.py --format all --scope kb

# Export a single document as HTML
python export/_scripts/export.py --format html --scope file --target _data/books/topic/chapter/doc.md

# Export a single note as Markdown
python export/_scripts/export.py --format markdown --scope note --target _data/notes/2025/03/note.md

# Export a single feed entry in all formats
python export/_scripts/export.py --format all --scope feed --target _data/feeds/2025/03/abc123.json

4. The script prints a JSON summary of all exported file paths to stdout.
5. Report the output paths back to the user.

Output Location

All exported files are saved under _data/exports/:

_data/exports/
  markdown/   ← .md files
  html/       ← standalone .html files (self-contained, with embedded images)
  pdf/        ← .pdf files (requires playwright)

File names mirror the source path structure. For example: _data/books/ai/chapter/doc.md → _data/exports/html/ai/chapter/doc.html

PDF Export Notes

PDF export uses Playwright (headless Chromium) to render the HTML to PDF. If Playwright is not installed, the script falls back to saving a self-printing HTML file (with window.onload = window.print()) and will notify the user to open it in a browser and use Print → Save as PDF.

To install Playwright:

pip install playwright && playwright install chromium

Rich Text Handling

• Math (KaTeX): All exported HTML files include KaTeX CDN scripts for math rendering.
• Images: Images are base64-encoded and embedded inline in HTML/PDF exports for full portability.
• Code blocks: Syntax-highlighted HTML is preserved from the knowledge base renderer.
• Tables: Standard HTML tables are preserved.

Resources

• export/_scripts/export.py: Main export script.
• display/_scripts/publish_viewer.py: Provides render_markdown_document() used for HTML rendering.
• _src/config.py: TapestryConfig for resolving project and data paths.