markdown-organizer

Mermaid 生成标准 Prompt（推荐直接复制到 AI 指令/系统提示中）

生成 Mermaid 代码时，所有节点内容都必须用英文双引号包裹（如 A["内容"]），节点 ID 只能用字母和数字，不能有括号、空格、点等特殊字符，subgraph 的 ID 不能和主节点重名。不允许裸写 add()、cognify()，必须写成 A["add()"]。

标准示例：

graph TD
   A["主节点"]
   B["add()"]
   C["cognify()"]
   A --> B
   A --> C

如需生成知识图谱、流程图等，务必遵循上述格式规范。

脚本说明

Commands 自动执行以下脚本：

# 1. 美化文档（下载图片、格式化）
python3 ${CLAUDE_PLUGIN_ROOT}/skills/markdown-organizer/scripts/organize_markdown.py <文件路径> [base_url]

# 2. A 按步骤执行增强
# - 分析文档内容
# - 生成摘要、知识图谱等增强内容
# - 插入到文档中

Markdown Organizer

概述

组织和美化从网页复制的 markdown 文件，自动下载图片到本地并更新引用。

调用方式

重要：这是一个在 AI 助手环境中使用的专属指令。请在 对应的输入框（如 Gemini CLI 的聊天框或 Claude Code 的命令面板）中输入来触发。

工作原理

此技能通过 Commands 调用脚本处理：

1. 脚本处理：下载图片、美化格式
2. AI 处理：按步骤生成摘要、知识图谱,并插入到文档中

AI 处理流程

当用户触发命令时，AI 会按以下步骤执行：

第零步：处理 Web Clipper 元数据（可选）

如果文件顶部包含 Web Clipper 格式的元数据（title, source, author, published 等）：

1. 合并 frontmatter：

   • 识别 YAML frontmatter 中的 Web Clipper 属性（title、source、author、published 等）
   • 将这些属性与文档现有的 frontmatter 合并
   • 如果现有 frontmatter 已有相同字段，以现有内容为准
   • 保留 title 字段在 frontmatter 中

2. 生成文档一级标题：

   • 在 frontmatter 的结束标记（---）之后，插入一个空行
   • 然后插入 # {title字段内容} 作为文档的一级标题
   • 确保标题和原文内容之间有一个空行
   • 例如：如果 title 是 "AI Knowledge Layer"，则插入 # AI Knowledge Layer

3. 清理和验证：

   • 删除已处理的 Web Clipper 临时元数据部分（如果有）
   • 检查 frontmatter 格式正确（YAML 语法无误）
   • 确保生成的文档结构清晰

文件结构示例：

---
title: AI Knowledge Layer
source: https://example.com
author: Author Name
---

# AI Knowledge Layer

原文内容...

如果文档没有 Web Clipper 元数据或没有 title 字段，直接跳过此步骤。

第一步：分析文档内容

读取原始文档，提取：

• 主标题和章节标题
• 首个标题后的核心内容
• 文档的整体主题和难度

第二步：生成增强内容

基于文档内容生成以下四个板块：

摘要

• 1-3 句话概括文档主要内容
• 包含核心概念和适用场景
• 避免过于笼统或过于详细，保持简洁明了
• 确保摘要内容与文档实际内容相关，不要虚构信息

知识图谱

• 生成 Mermaid mindmap 或 flowchart
• 展现文档的核心概念和层级关系
• 格式：```mermaid ... ```
• Mermaid 语法规范（Obsidian 兼容）：
  • 推荐：mindmap 格式（最安全）
  • 可用的节点形状：
    • 矩形：[文本]
    • 圆角矩形：(文本)
    • 菱形：{文本}
  • 禁止：[/text]、[\text]、([text])、{{text}} 等复杂形状
  • 避免在节点文本中使用特殊字符（保持简洁）
• 包含 3-5 个主要概念的层级关系
• 确保图谱内容与文档实际内容相关，不要虚构信息

第三步：更新文件

现在将第二步生成的四个板块直接写入文件：

1. 确定插入位置：

   • 如果文档有 YAML frontmatter，在 frontmatter 之后
   • 如果没有 frontmatter，在文档最顶部

2. 构建完整内容：

   • 根据第二步的内容，拼接以下四个板块：
     1. ## 摘要 + 摘要内容
     2. ## 知识图谱 + Mermaid 代码块
   • 确保块之间各空一行

3. 保存文件：

   • 在确定的插入位置插入这些内容
   • 确保最后一个块和原文内容之间空一行
   • 确保文件末尾有换行符
   • 立即将修改保存到文件

第四步：执行脚本处理图片和格式

python3 ${CLAUDE_PLUGIN_ROOT}/skills/markdown-organizer/scripts/organize_markdown.py {file_path} [base_url]

这一步自动完成：下载图片、更新图片引用、美化格式。

第五步：完成并报告

自动检查和确认（不需要用户确认）：

1. 自动验证：

   • ✓ 验证所有增强内容都基于文档实际内容
   • ✓ 确认没有重复的摘要（如文档已有 "## 摘要" 或 "## 概述"，应已跳过）
   • ✓ 检查 Markdown 格式正确无误
   • ✓ 确保文件末尾有换行符

2. 生成完成报告（直接显示，无需询问）：

   • 📝 列出已插入的五个内容块
   • 🖼️ 报告已下载的图片数量和更新情况
   • ✅ 确认文件已保存的路径
   • 📊 简要说明增强内容的质量检查结果

重要：不要询问用户是否需要"预览"或"diff"，直接完成并显示简明报告即可。

关键要点

内容质量：每句话都要有意义，基于文档实际内容生成，不要虚构信息。

位置正确：增强内容必须在文档顶部（frontmatter 下方），处理图片和格式在插入增强内容之后。

语言一致性：与原文保持一致的语言和风格（中文）。

不修改原文：只在指定位置添加新内容。

功能说明

1. 创建 img 文件夹：在 markdown 文件同目录下创建 img 文件夹
2. 下载图片：提取并下载所有图片到 img 文件夹（使用 MD5 哈希命名）
3. 更新引用：将图片引用更新为本地路径 ./img/filename.jpg
4. 美化格式：标题空行、列表规范化、删除多余空行等
5. 内容增强：基于文档内容自动生成：
   • 摘要：概括文档主要内容
   • 知识图谱：Mermaid 图展现核心概念关系

脚本说明

Commands 自动执行以下脚本：

# AI 按步骤生成增强内容（摘要、知识图谱）
# 并插入到文档顶部

# 然后执行脚本处理图片和美化格式
python3 ${CLAUDE_PLUGIN_ROOT}/skills/markdown-organizer/scripts/organize_markdown.py <文件路径> [base_url]

# 最后 Claude 检查和保存

依赖

pip install requests

手动运行脚本

# 脚本位置
ls -la scripts/

# 方式1：依次运行两个脚本
python3 ${CLAUDE_PLUGIN_ROOT}/skills/markdown-organizer/scripts/organize_markdown.py <文件路径> [base_url]
python3 ${CLAUDE_PLUGIN_ROOT}/skills/markdown-organizer/scripts/enhance_content.py --enhance <文件路径>

# 方式2：仅运行美化脚本
python3 ${CLAUDE_PLUGIN_ROOT}/skills/markdown-organizer/scripts/organize_markdown.py <文件路径> [base_url]

# 方式3：仅运行增强脚本
python3 ${CLAUDE_PLUGIN_ROOT}/skills/markdown-organizer/scripts/enhance_content.py --enhance <文件路径>