← Back to Skills Marketplace
infniu

Convert Notion HTML exports to interactive mind maps

by infniu · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
114
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install notion-to-mindmap
Description
将 Notion 导出的 HTML 文件转换为可交互的思维导图 HTML。支持右键跳转到 Notion 页面链接、搜索、缩放、展开/折叠等功能。当用户提供 Notion HTML 导出文件、提到"思维导图"、"mindmap"、或希望可视化 Notion 页面结构时使用。
README (SKILL.md)

\r \r

Notion to Mind Map\r

\r 将用户的 Notion HTML 导出转换为可交互的思维导图。\r \r

核心交互功能\r

\r | 操作 | 效果 |\r |------|------|\r | 空白处拖拽 | 平移画布 |\r | 鼠标滚轮 | 缩放(每级 5%,右下角显示比例) |\r | 左键单击节点 | 展开/折叠(位置保持不变) |\r | Ctrl+左键 | 直接在浏览器打开 Notion 页面 |\r | 右键节点 | 复制链接 / 聚焦此页面 |\r | Ctrl+F | 聚焦搜索框,实时高亮跳转 |\r \r

顶部工具栏\r

\r

  • 重置:展开到第 2 级,100% 缩放\r
  • 适应屏幕:自动缩放显示全部展开节点\r
  • 展开全部 / 折叠全部\r
  • 统计:显示页面总数和最大层级\r \r

使用方式\r

\r 用户只需要发送 Notion 导出的 index.html 文件给我,我会自动完成所有转换工作,输出可直接打开的 mindmap.html。\r \r

工作流程\r

\r

  1. 用户发送 Notion 导出的 index.html\r
  2. 我运行 build_mindmap.py 解析 HTML → 生成 mindmap_data.json\r
  3. 我运行 generate_html.py 生成 mindmap.html\r
  4. 我将 mindmap.html 返回给用户\r \r

依赖要求\r

\r 需要 BeautifulSoup4:\r

pip install beautifulsoup4\r
```\r
\r
## Notion 链接说明\r
\r
生成的 Notion 链接格式为:`https://www.notion.so/\x3Cworkspace>/\x3Cpage-id>`\r
\r
如果用户需要自定义工作空间前缀(默认从 HTML 中解析),可以修改 `build_mindmap.py` 中的 `NOTION_BASE` 常量。\r
\r
## 数据结构说明\r
\r
页面层级对应:\r
- Level 0:根节点(工作空间名称)\r
- Level 1:一级页面(Notion 导出的顶层页面)\r
- Level 2+:逐级展开\r
\r
脚本会自动跳过 CSV 数据库条目,并从 `\x3Cul id>` 中提取真实的 32 位页面 UUID。\r
\r
## 详细参考\r
\r
- [README.md](README.md) — 完整的 Notion 链接格式、层级定义、交互细节\r
Usage Guidance
This skill appears to do what it says: it reads a Notion export (index.html), builds a JSON representation, and creates a self-contained interactive HTML mindmap. Before using: (1) Only provide exports you are comfortable sharing — the export may contain private content and page URLs that will be embedded in the generated HTML. (2) If you plan to open generated Notion links in a browser, be aware those links point to the workspace/page IDs parsed from the export. (3) The only runtime dependency is BeautifulSoup4 (pip); run scripts offline if you prefer. (4) If you have strong security concerns, inspect the two included Python files locally (they are short and readable) before running them.
Capability Analysis
Type: OpenClaw Skill Name: notion-to-mindmap Version: 1.0.0 The skill bundle is a legitimate utility for converting Notion HTML exports into interactive mindmaps. The Python scripts (build_mindmap.py and generate_html.py) perform local file parsing and HTML generation using standard libraries like BeautifulSoup4, with no evidence of data exfiltration, malicious execution, or harmful prompt injection. The generated output is a self-contained HTML file for visualization purposes.
Capability Assessment
Purpose & Capability
Name/description match the included artifacts: two Python scripts parse an exported index.html, produce mindmap_data.json, and generate a self-contained mindmap.html. No unrelated binaries, env vars, or services are requested.
Instruction Scope
SKILL.md explicitly instructs the agent to accept a Notion index.html, run build_mindmap.py to produce JSON, then run generate_html.py to create mindmap.html and return it. The scripts only read the provided HTML and write local output files; instructions do not ask the agent to read other files, gather system data, or post data to external endpoints.
Install Mechanism
No install spec is provided (instruction-only with included scripts). The only declared dependency is BeautifulSoup4 (pip install beautifulsoup4). No downloads from untrusted URLs or archive extraction are used.
Credentials
The skill requests no environment variables, no credentials, and no config paths. The code does attempt to detect a Notion base URL by scanning links in the provided HTML, which is appropriate for the stated functionality.
Persistence & Privilege
always is false and the skill does not attempt to modify other skills, system settings, or persist beyond its own output files. It operates only on input HTML and local outputs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install notion-to-mindmap
  3. After installation, invoke the skill by name or use /notion-to-mindmap
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Convert Notion HTML exports to interactive mind maps
Metadata
Slug notion-to-mindmap
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Convert Notion HTML exports to interactive mind maps?

将 Notion 导出的 HTML 文件转换为可交互的思维导图 HTML。支持右键跳转到 Notion 页面链接、搜索、缩放、展开/折叠等功能。当用户提供 Notion HTML 导出文件、提到"思维导图"、"mindmap"、或希望可视化 Notion 页面结构时使用。 It is an AI Agent Skill for Claude Code / OpenClaw, with 114 downloads so far.

How do I install Convert Notion HTML exports to interactive mind maps?

Run "/install notion-to-mindmap" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Convert Notion HTML exports to interactive mind maps free?

Yes, Convert Notion HTML exports to interactive mind maps is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Convert Notion HTML exports to interactive mind maps support?

Convert Notion HTML exports to interactive mind maps is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Convert Notion HTML exports to interactive mind maps?

It is built and maintained by infniu (@infniu); the current version is v1.0.0.

💬 Comments