export
starsforks
How to install export?
natsufox/tapestry/export
$npx -y skills add NatsuFox/Tapestry --skill exportExport knowledge base content to PDF, Markdown, or HTML files saved under _data/exports/. Use when a user wants to save or share KB content as downloadable files. Supports exporting a single document file, a single feed entry, a single note, or the entire knowledge base.
SKILL.md
| 1 | # Tapestry Export |
| 2 | |
| 3 | Export knowledge base content to portable file formats: **$ARGUMENTS** |
| 4 | |
| 5 | ## When to use this skill |
| 6 | |
| 7 | Use this skill when: |
| 8 | - A user wants to export, save, download, or share knowledge base content |
| 9 | - The user asks for a PDF, Markdown, or HTML version of a document or the whole KB |
| 10 | - The user wants offline-readable files from the knowledge base |
| 11 | - The user wants to share a chapter or article outside the viewer |
| 12 | |
| 13 | ## Arguments |
| 14 | |
| 15 | The argument string may contain any combination of: |
| 16 | |
| 17 | - **format**: `pdf`, `markdown`, `html`, or `all` (default: `all`) |
| 18 | - **scope**: `file`, `note`, `feed`, or `kb` (default: `kb`) |
| 19 | - **target**: a path or partial path to the target artifact (required for `file`, `note`, `feed` scopes) |
| 20 | |
| 21 | Examples: |
| 22 | - `"pdf kb"` — export the entire knowledge base as PDF |
| 23 | - `"html file _data/books/ai/chapter.md"` — export one document as HTML |
| 24 | - `"all note _data/notes/2025/03/my-note.md"` — export one note in all three formats |
| 25 | - `"markdown feed _data/feeds/2025/03/abc123.json"` — export one feed entry as Markdown |
| 26 | |
| 27 | ## Scope Resolution |
| 28 | |
| 29 | | Scope | Source files | Notes | |
| 30 | |---|---|---| |
| 31 | | `file` | Single `.md` file under `_data/books/` | Path provided by user | |
| 32 | | `note` | Single `.md` file under `_data/notes/` | Path provided by user | |
| 33 | | `feed` | Single `.json` file under `_data/feeds/` | Exports the `body` field as Markdown | |
| 34 | | `kb` | All `.md` files under `_data/books/` recursively | Entire knowledge base | |
| 35 | |
| 36 | ## Workflow |
| 37 | |
| 38 | 1. Parse the argument to determine format, scope, and target. |
| 39 | 2. Change to the project root directory. |
| 40 | 3. Run the export script: |
| 41 | |
| 42 | ```bash |
| 43 | # Export entire KB as PDF |
| 44 | python export/_scripts/export.py --format pdf --scope kb |
| 45 | |
| 46 | # Export entire KB in all formats |
| 47 | python export/_scripts/export.py --format all --scope kb |
| 48 | |
| 49 | # Export a single document as HTML |
| 50 | python export/_scripts/export.py --format html --scope file --target _data/books/topic/chapter/doc.md |
| 51 | |
| 52 | # Export a single note as Markdown |
| 53 | python export/_scripts/export.py --format markdown --scope note --target _data/notes/2025/03/note.md |
| 54 | |
| 55 | # Export a single feed entry in all formats |
| 56 | python export/_scripts/export.py --format all --scope feed --target _data/feeds/2025/03/abc123.json |
| 57 | ``` |
| 58 | |
| 59 | 4. The script prints a JSON summary of all exported file paths to stdout. |
| 60 | 5. Report the output paths back to the user. |
| 61 | |
| 62 | ## Output Location |
| 63 | |
| 64 | All exported files are saved under `_data/exports/`: |
| 65 | |
| 66 | ``` |
| 67 | _data/exports/ |
| 68 | markdown/ ← .md files |
| 69 | html/ ← standalone .html files (self-contained, with embedded images) |
| 70 | pdf/ ← .pdf files (requires playwright) |
| 71 | ``` |
| 72 | |
| 73 | File names mirror the source path structure. For example: |
| 74 | `_data/books/ai/chapter/doc.md` → `_data/exports/html/ai/chapter/doc.html` |
| 75 | |
| 76 | ## PDF Export Notes |
| 77 | |
| 78 | PDF export uses Playwright (headless Chromium) to render the HTML to PDF. |
| 79 | If Playwright is not installed, the script falls back to saving a self-printing HTML file |
| 80 | (with `window.onload = window.print()`) and will notify the user to open it in a browser |
| 81 | and use Print → Save as PDF. |
| 82 | |
| 83 | To install Playwright: |
| 84 | ```bash |
| 85 | pip install playwright && playwright install chromium |
| 86 | ``` |
| 87 | |
| 88 | ## Rich Text Handling |
| 89 | |
| 90 | - **Math (KaTeX)**: All exported HTML files include KaTeX CDN scripts for math rendering. |
| 91 | - **Images**: Images are base64-encoded and embedded inline in HTML/PDF exports for full portability. |
| 92 | - **Code blocks**: Syntax-highlighted HTML is preserved from the knowledge base renderer. |
| 93 | - **Tables**: Standard HTML tables are preserved. |
| 94 | |
| 95 | ## Resources |
| 96 | |
| 97 | - `export/_scripts/export.py`: Main export script. |
| 98 | - `display/_scripts/publish_viewer.py`: Provides `render_markdown_document()` used for HTML rendering. |
| 99 | - `_src/config.py`: `TapestryConfig` for resolving project and data paths. |
People who liked this also viewed
6 picksType
- lark-drive飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sSkillsJul 2026
- lark-sharedUse for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handlingSkillsJul 2026
- lark-whiteboard飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责：飞书云文档内容编辑（lark-doc）、文档内嵌电子表格/Base（lark-sheets / lark-base）。SkillsJul 2026
- lark-task飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。SkillsJul 2026
- lark-attendance飞书考勤打卡：查询自己的考勤打卡记录SkillsJul 2026
- lark-apps妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用角色与成员管理、自动化触发器（定时/记录变更/Webhook/飞书审批）。当用户要SkillsJul 2026
