Markdown AI Rewriter Skill

本 Skill 对应 npm 包 markdown-ai-rewriter（当前对齐 v1.2.5）：在 尽量保留标题、代码块、表格、图片等结构 的前提下，用大模型改写正文（润色、降重、换风格等），并支持 图片生成（图生图）、视频生成（文生视频）和 音乐生成（文生音乐）。

🚀 安装后快速开始

安装完成后，运行以下命令查看可用功能：

md-rewrite rewrite -i article.md -o out.md -p openai -v

输出示例：

📋 功能状态：
   ⬚ 文章改写 (--rewrite)
   ⬚ 图片生成 (--process-images)
   ⬚ 视频生成 (--generate-video)

⚠️  未启用任何功能。请使用以下选项启用：
   --rewrite         启用文章改写
   --process-images  启用图片生成
   --generate-video  启用视频生成

重要：v0.5.2 起，默认不启用任何功能，需要显式指定要启用的功能。

核心特点（先看这个）

一句话定位：这是一个面向生产场景的 Markdown 改写 Skill，重点是"改写质量 + 结构稳定 + 成本可控"。

• 结构稳定优先：尽量保留标题层级、代码块、表格、图片位置，减少"改完排版坏掉"。
• 双模式可切换：section 适合中长文批量与控成本，full 适合短文叙事连贯。
• 多模型一套命令：同一 CLI 只换 -p 和环境变量，就能切换 11 个 Provider。
• 图片生成：支持 MiniMax、OpenAI、Gemini、豆包等图片生成。
• 视频生成：支持 MiniMax Hailuo、豆包 Seedance、可灵、Runway 等视频生成。
• 音乐生成：支持 MiniMax Music 2.5+ 音乐生成（纯音乐/带歌词）。
• 可落地到流水线：适合接在抓取、清洗、发布前的"内容标准化"环节。

最适合的使用场景

• 你已经有 Markdown 初稿，要做润色/降重/统一风格；
• 你在做批量内容处理，希望速度和费用可控；
• 你需要兼顾国内外多个模型平台，在可用性和成本之间灵活切换；
• 你需要为文章自动生成配图、视频或背景音乐。

与旧版差异（务必知晓）

安装

全局或项目内安装均可：

npm install -g markdown-ai-rewriter
# 或
npm install markdown-ai-rewriter

使用 OpenAI 或 MiniMax 时，需安装 peer 依赖 openai：

npm install openai

使用 Anthropic 时：

npm install @anthropic-ai/sdk

可执行命令：markdown-ai-rewrite 或 md-rewrite。

环境变量

何时使用本 Skill

适合触发：

• 用户要「改写 / 润色 / 降重 / 换风格」已有 Markdown，且希望 保留文档结构；
• 提到「章节改写」「全文改写」「技术文档 / 博客 / 公众号稿」等；
• 需要指定 casual / formal / technical / creative / custom 风格。

不适合：

• 从零「写一篇新文章」且输入不是 Markdown 改写流程；
• 纯格式转换（如 MD→HTML）；
• 仅分析结构、不做改写。

触发关键词示例：「重写这篇 md」「改成正式一点」「全文连贯改写」「按章节改」「用 MiniMax / OpenAI / Claude」。

两种改写模式（CLI：--mode）

• --section-level 1|2|3：仅章节模式有效，表示按几级标题切分（默认 1 级 #）。
• --mode full 时 token 消耗可能更大，适合长文时谨慎使用。

标准 CLI 示例

文章改写

# 章节模式 + OpenAI（注意：需要 --rewrite 显式启用改写）
export OPENAI_API_KEY="sk-..."
md-rewrite rewrite \
  -i input.md \
  -o output.md \
  -p openai \
  --rewrite \
  -s casual \
  -c 3 \
  -v

# 全文模式
md-rewrite rewrite -i input.md -o out.md -p openai --rewrite --mode full -v

# 二级标题分章
md-rewrite rewrite -i input.md -o out.md -p openai --rewrite --section-level 2

# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
md-rewrite rewrite -i input.md -o out.md -p anthropic --rewrite -s formal

# DeepSeek
export DEEPSEEK_API_KEY="..."
md-rewrite rewrite -i input.md -o out.md -p deepseek --rewrite

# MiniMax（需 npm install openai）
export MINIMAX_API_KEY="..."
md-rewrite rewrite -i input.md -o out.md -p minimax --rewrite -m MiniMax-M2.1 -s casual

图片生成

# 只生成图片（不改写文章）
export MINIMAX_API_KEY="..."
md-rewrite rewrite -i input.md -o out.md -p minimax --process-images -v

# 改写 + 图片生成
md-rewrite rewrite -i input.md -o out.md -p openai --rewrite --process-images -v

# 指定图片 Provider
md-rewrite rewrite -i input.md -o out.md -p openai --process-images --image-provider doubao

视频生成

# 只生成视频（不改写文章）
export MINIMAX_API_KEY="..."
md-rewrite rewrite -i input.md -o out.md -p minimax --generate-video -v

# 改写 + 视频生成
md-rewrite rewrite -i input.md -o out.md -p openai --rewrite --generate-video -v

# 指定视频 Provider（豆包 Seedance）
export DOUBAO_API_KEY="..."
md-rewrite rewrite -i input.md -o out.md -p openai --generate-video --video-provider doubao

# 可灵视频
export KLING_API_KEY="..."
md-rewrite rewrite -i input.md -o out.md -p openai --generate-video --video-provider kling

# Runway 视频
export RUNWAY_API_KEY="..."
md-rewrite rewrite -i input.md -o out.md -p openai --generate-video --video-provider runway

音乐生成

# 纯音乐（无人声）- 从 prompt 生成
export MINIMAX_API_KEY="..."
md-rewrite music --prompt "Indie folk, melancholic, introspective" --instrumental -o bgm.mp3

# 带歌词的歌曲
md-rewrite music --prompt "Pop, upbeat, energetic" --lyrics "[verse]\nHello world\n[chorus]\nLa la la" -o song.mp3

# 从文件读取歌词
md-rewrite music --prompt "Rock, powerful" --lyrics-file lyrics.txt -o song.mp3

# 自动生成歌词（从 prompt 自动生成）
md-rewrite music --prompt "Jazz, smooth, romantic" --auto-lyrics -o song.mp3

# 从 Markdown 生成背景音乐
md-rewrite music -i article.md --instrumental -o bgm.mp3 -v

组合使用

# 改写 + 图片 + 视频（全功能）
md-rewrite rewrite -i input.md -o out.md -p openai \
  --rewrite \
  --process-images \
  --generate-video \
  -v

常用参数速查：-i/-o 输入输出，-p 厂商，-k 显式传 Key（也可全靠环境变量），-m 模型，--base-url（通用 endpoint 覆盖），-s 风格，-t 温度，--max-tokens，--preserve-length，-c 并发，--mode，--section-level，--rewrite，--process-images，--generate-video，--video-provider，--image-provider。完整列表以 md-rewrite rewrite --help 为准。

编程 API（TypeScript）

import { MarkdownRewriter } from 'markdown-ai-rewriter';

const rewriter = new MarkdownRewriter({
  provider: 'openai', // 'anthropic' | 'azure-openai' | 'gemini' | 'deepseek' | 'openrouter' | 'qwen' | 'glm' | 'doubao' | 'wenxin' | 'minimax' | 'custom'
  apiKey: process.env.OPENAI_API_KEY,
  model: 'gpt-4o-mini',
  mode: 'section',       // 或 'full'
  sectionLevel: 1,
  concurrency: 3,
  verbose: true,
  enableRewrite: true,   // v0.5.2 起需要显式启用改写
  minimaxBaseUrl: process.env.MINIMAX_BASE_URL, // 仅 minimax 时可选
  options: {
    style: 'casual',
    temperature: 0.7,
    maxTokens: 2000,
  },
  // 图片生成配置（可选）
  imageProcessing: {
    provider: 'minimax',
    apiKey: process.env.MINIMAX_API_KEY,
  },
  // 视频生成配置（可选）
  videoProcessing: {
    provider: 'minimax', // 'minimax' | 'doubao' | 'kling' | 'runway'
    apiKey: process.env.MINIMAX_API_KEY,
    duration: 6,
  },
});

const result = await rewriter.rewrite(markdownString);
// result.rewritten, result.blocksProcessed, result.blocksRewritten
// result.imageProcessing, result.videoProcessing

custom 提供方可使用 customProvider 注入，详见 npm 包 README。

输出与行为说明

• 章节 / 全文 均基于当前实现的解析与重组逻辑；标题、代码块、表格等会尽量保留；图片在全文模式下通过占位符机制处理。
• 列表、引用等是否逐条保留，与模型输出有关；若强约束，请在 --prompt 中明确要求。
• 统计字段 blocksProcessed / blocksRewritten 在章节模式下对应章节单元等粒度，与旧版「按段落块计数」的日志不完全相同。

常见问题

1. 提示缺少 API Key
请设置与 -p 一致的环境变量，或使用 -k 传入。

2. MiniMax 报错找不到模块
执行 npm install openai（MiniMax 使用 OpenAI 兼容客户端）。

3. 改写后结构不满意
尝试切换 --mode section / full、调整 --section-level、缩小 --max-tokens、或在 --prompt 中强调「保留所有 Markdown 列表与表格结构」。

4. 费用
以各云厂商定价为准；OpenAI 小模型、MiniMax 与 Anthropic 价差较大，README 中有量级参考。

与其他工具串联（示例）

convert-url --url "https://example.com/article" --output article.md

markdown-ai-rewrite rewrite -i article.md -o article-rewritten.md -p openai -s casual

发布等步骤按你的流水线工具执行即可。

维护说明

相关项目

• news-to-markdown — 网页/新闻转 Markdown
• wechat-md-publisher — Markdown 发布到微信