Markdown Organizer v1.0.9
1.0.9 更新内容
- 合并 frontmatter 逻辑优化，所有字段遵循“空则覆盖”原则，tags 合并去重，完全满足合并需求。
组织和美化从网页复制的 Markdown 文档，支持直接从 URL 转换网页为 Markdown，自动下载图片到本地并更新引用，利用 Claude 的智能思考生成学习目标和前置知识。
✨ 功能特性
| 功能 | 描述 |
|---|
| 🌐 URL 转 Markdown | 直接从网页 URL 获取内容并转换为清晰的 Markdown 文档 |
| 📥 图片本地化 | 自动下载 Markdown 中的图片到 img 文件夹，使用 MD5 哈希命名避免冲突 |
| 🔗 路径更新 | 将图片引用从网络 URL 自动更新为本地路径 ./img/filename.jpg |
| 🎨 格式美化 | 标题空行、列表规范化、删除多余空行，统一格式 |
| 🤖 AI 内容增强 | Claude 智能生成学习目标、前置知识、FAQ（无需配置） |
🚀 快速开始
系统要求
- Python 3.6+
- Node.js 14.0+
- pip（Python包管理器）
安装
通过 GitHub 安装（推荐，无需发布到 npm）
直接从 GitHub 仓库安装：
# 克隆仓库
git clone https://github.com/xiaodizi/organize_markdown_skills.git
cd organize_markdown_skills
# 方式一：全局安装（推荐）
npm link
# 方式二：直接运行安装向导
node bin/cli.js skills:add
# 方式三：通过 npx 运行（从GitHub）
npx github:xiaodizi/organize_markdown_skills skills:add
安装后，按照提示在 Claude Code 或 Gemini CLI 中完成插件配置。
npx 直接使用三个命令（无需安装）
你也可以不安装，直接通过 npx 运行任意一个命令：
# 直接从 GitHub 运行
npx github:xiaodizi/organize_markdown_skills markdown-organizer input.md
npx github:xiaodizi/organize_markdown_skills url-to-markdown https://example.com output.md
npx github:xiaodizi/organize_markdown_skills wechat-format input.md output.html
说明：本项目不需要发布到 npm 注册表，直接通过 GitHub 即可安装和使用。
Claude Code 插件安装
# 1. 添加市场源
/plugin marketplace add xiaodizi/organize_markdown_skills
# 2. 安装插件
/plugin install organize_markdown
💡 自动安装依赖：插件启动时会自动检查并安装缺失的 Python 依赖，不需要手动安装。
Gemini CLI 安装
# 安装 skill（会自动发现 .gemini/skills 目录）
gemini skills install https://github.com/xiaodizi/organize_markdown_skills.git
# 或者指定具体路径安装单个 skill
gemini skills install https://github.com/xiaodizi/organize_markdown_skills.git --path .gemini/skills/markdown-organizer
更新 Gemini CLI 技能
重新安装即可更新到最新版本：
# 更新全部技能
gemini skills install https://github.com/xiaodizi/organize_markdown_skills.git
# 更新单个 skill
gemini skills install https://github.com/xiaodizi/organize_markdown_skills.git --path .gemini/skills/markdown-organizer
Gemini CLI 使用
# 查看已安装的 skills
gemini skills list
# 在 Gemini CLI 会话中直接使用完整命令（注意：Gemini CLI 不支持 "/" 命令自动补全）
/markdown-organizer @文件路径 [base_url]
/url-to-markdown <URL> [输出文件路径]
/wechat-format @文件路径 [输出路径]
# 或者使用自然语言
# "帮我美化这个 markdown 文档"
# "把这个网页保存为 markdown"
# "帮我转换为微信公众号格式"
重要提示：Google Gemini CLI (v0.32.1) 不支持 Claude Code 的 "/" 命令自动补全功能。安装技能后，您需要直接输入完整的命令（如 /markdown-organizer）来使用功能，而不是期望输入 "/" 后显示命令列表。
使用
markdown-organizer - 美化现有 Markdown 文档
# 基本用法
/markdown-organizer @/path/to/article.md
# 处理相对路径图片（需要提供原网页 URL）
/markdown-organizer @article.md https://example.com/post/123
url-to-markdown - 从 URL 直接转换为 Markdown
# 基本用法（自动生成文件名）
/url-to-markdown https://example.com/post/123
# 指定输出文件路径
/url-to-markdown https://example.com/post/123 ./docs/article.md
wechat-format - Markdown 转换为微信公众号 HTML
# 基本用法（自动生成 *_wechat.html）
/wechat-format @/path/to/article.md
# 指定输出文件路径
/wechat-format @article.md ./article.html
# 不在标题添加 Emoji
/wechat-format @article.md ./article.html --no-emoji
自然语言触发
markdown-organizer:
"@文件路径 帮我美化文档""处理这个 markdown 文件"
url-to-markdown:
"把这个网页保存为 markdown""将 URL 转换为 markdown 文档"
wechat-format:
"帮我把这个 markdown 转换为微信公众号格式""转换为微信公众号 HTML"
💻 系统终端命令
通过 npm install 或 npm link 安装后，系统终端将可用以下命令：
主要功能命令
# markdown-organizer - 组织和美化现有 Markdown 文档
markdown-organizer input.md
markdown-organizer input.md https://example.com/post
# url-to-markdown - 从 URL 转换为 Markdown
url-to-markdown https://example.com/post/123
url-to-markdown https://example.com/post/123 output.md
url-to-markdown https://example.com/post/123 output.md --render # 启用 JS 渲染
# wechat-format - Markdown 转换为微信公众号 HTML
wechat-format input.md
wechat-format input.md output.html
wechat-format input.md output.html --no-emoji # 不在标题添加 Emoji
安装辅助命令
# skills-add-organize-markdown - Claude Code 技能安装向导
skills-add-organize-markdown
临时使用（无需安装）
如果不想全局安装，也可以通过 npx 临时使用：
# 通过 GitHub 仓库临时运行
npx github:xiaodizi/organize_markdown_skills markdown-organizer input.md
npx github:xiaodizi/organize_markdown_skills url-to-markdown https://example.com/post/123 output.md
npx github:xiaodizi/organize_markdown_skills wechat-format input.md output.html
命令说明：
- 全局安装（
npm link）后，所有命令可在任何目录直接使用
- 临时使用（
npx）无需安装，适合 CI/CD 或一次性任务
- 所有命令都支持
--help 参数查看详细用法
📖 详细说明
安装方式对比
