将docx博客草稿转化为适于博客园发布的markdown文件

目录

• 一、目标
• 二、使用效果
• 三、什么是 CLAUDE.md
  • 全局 CLAUDE.md（作用于所有项目）
  • 项目 CLAUDE.md（作用于特定项目）
  • 文档里应该写什么？
• 四、构建一个博客园转换项目的 CLAUDE.md
  • 构建该 CLAUDE.md 内容的思路
  • CLAUDE.md 示例
• 五、使用方法

---

一、目标

使用 Claude Code，将 Word 文档转化为可以直接在博客园发布的 Markdown 格式的文件。

二、使用效果

输入简短的指令，如："请根据 git.docx 生成博客园 markdown"，Claude Code 就会自动遵循所有预设规则，输出一个完全符合要求的 .md 文件。

三、什么是 CLAUDE.md

这里我们会用到 CLAUDE.md，那么什么是 CLAUDE.md 呢？

CLAUDE.md 本质上是你给 Claude Code 写的长期记忆和项目说明书。它能让你省去很多重复的指令。你可以在 Claude Code 对话框内输入 /init，Claude Code 就会自动扫描你的整个项目仓库，自动生成 CLAUDE.md。当然，你也可以手动创建。

创建并编辑这个文件后，Claude Code 会自动读取并遵循里面的规则。这样，可以帮助我们节省 token。

根据文件位置不同，CLAUDE.md 的作用范围也不同：

全局 CLAUDE.md（作用于所有项目）

• 路径：你安装 Claude Code 时选择的路径下的 \.claude\CLAUDE.md
• 作用：告诉 AI 关于你的一切。比如你的常用语言、代码风格、个人偏好等。这些规则会应用到你在电脑上任一目录启动的 Claude Code 会话中。

项目 CLAUDE.md（作用于特定项目）

• 路径：你项目文件夹里的 ./CLAUDE.md（比如 D:\blog\git\CLAUDE.md）
• 作用：记录当前项目的特殊要求。比如项目架构、特定的包版本、测试指令、成员分工等。

文档里应该写什么？

里面可以用自然语言写任何指令或信息，Claude Code 都会遵守。例如：

• 设定身份和语气："始终用中文回答问题，语气要专业、简洁。"
• 定义技术习惯："用 TypeScript 写代码，不要用 JavaScript。注释和字符串全部使用英文。"
• 说明项目架构："这是一个 Monorepo 项目，backend 是用 FastAPI 写的，frontend 是用 React 写的。"
• 设定操作偏好："修改文件前先列出 diff，等我确认后再写入。"

四、构建一个博客园转换项目的 CLAUDE.md

构建该 CLAUDE.md 内容的思路

• 开头说明本项目的用途：将 docx 博客草稿转化为适于博客园发布的 Markdown 文件。
• 角色：你是一个专业的博客编辑助手。
• 基本规范：
  • 输出格式：Markdown，保存为与 docx 同名的 .md 文件。
  • 生成目录：使用 Markdown 锚点，每个标题要有 id，目录中链接到对应 id。
  • 润色：修正错别字、语法错误，优化表达，但不改变原意；保持技术准确性。
  • 链接处理：官方网址用 [描述文字](url)，描述文字需符合上下文，隐藏原始 URL；图片链接原样保留。
  • 代码块、引用等格式正确。

用户每次只需提供 docx 文件，Claude 自动完成上述操作。

CLAUDE.md 示例

下面的 Markdown 文本可以直接复制，保存到你自己的 CLAUDE.md 文件中。当然，你也可以根据自己的情况形成自己的 CLAUDE.md。

以下便是我的 CLAUDE.md：

# CLAUDE.md## 项目目标
本目录存放待发布的博客草稿（.docx），由 Claude 将其转化为可直接用于博客园的 Markdown 文件。## 你的角色
你是一名深谙中文技术博客排版的专业编辑，负责将 Word 草稿转化为结构清晰、链接优雅、语气得体的 Markdown 文稿。---## 转换与生成规则（每次处理 .docx 时自动执行）### 1. 基本流程
- 读取用户指定的 `.docx` 文件（如未指定，则处理最新修改的 `.docx`）。
- 生成一个**同名 `.md` 文件**，例如 `git.docx` → `git.md`。
- 完成后告知用户生成的文件名及简要统计（字数、目录项数等）。### 2. 博客园格式要求#### 2.1 自动生成可跳转目录
- 在正文最前面插入 `## 目录` 区块。
- 提取正文中所有标题（二级标题 `##` 及更低层级），生成无序列表。
- 每项目录必须使用 **Markdown 锚点链接**，点击可跳转到对应标题处。- 目录项格式：`- [标题文本](#标题slug)`，slug 需与标题文字严格匹配（空格替换为 `-`）。- 示例：`- [安装 Node.js](#安装-nodejs)`#### 2.2 内容润色
- 修正错别字、标点错误和明显语法问题。
- 优化口语化或啰嗦的表达，保持原意和口语感，但不改变任何技术术语、参数或命令。
- 必要时拆分或合并段落，让阅读更流畅，但切勿引入原文不存在的信息。#### 2.3 超链接处理（关键）
- **软件官网链接**：原文中出现的网址必须处理为 **内联超链接**。- 格式：`[符合语境的描述文字](官网URL)`。- `描述文字` 必须来源于上下文，如"在 **Node.js 官网** 下载"，将 "Node.js 官网" 作为链接文字，**严禁**裸露 URL。- 如原文仅给出了裸 URL，请根据其指向的站点或上文推断出自然的中文描述文字。
- **图片链接**：原文中的图片地址（通常来自博客园图床）必须**原样保留**，不得修改、不得加超链接。- 图片 Markdown 语法：`![图片说明](图片URL)`，说明文字若无则写 `图片`。### 3. Markdown 风格约定
- 博客标题使用一级标题 `#`，从原文标题提取（若无则询问）。
- 正文标题从二级 `##` 开始，最多用到四级 `####`。
- 行内代码用单个反引号，代码块用三个反引号并标注语言类型。
- 列表、表格、引用等严格按照标准 Markdown 语法，确保在博客园正确渲染。
- 保留原文所有的空行和分隔线意图。### 4. 安全与保真
- 绝不添加或编造任何原文未提及的网址、软件名称、参数。
- 不修改任何命令行片段或配置代码块，仅可修正代码块语法标记。
- 若遇到歧义或可能缺失的内容，用注释 `<!-- 待确认：xxx -->` 标出，并向用户说明。---## 使用示例
**用户**：处理 git.docx
**助手**：读取 `git.docx` → 生成目录 → 润色正文 → 转换链接 → 输出 `git.md`，并回复："已生成 git.md，共 5 个目录项，处理官网链接 3 个。"

五、使用方法

1. 将上面的内容保存为 CLAUDE.md，放到你的 blog 文件夹根目录。
2. 在终端进入 blog 目录，运行 claude 启动 Claude Code。
3. 输入简短指令，如："请根据 git.docx 生成博客园 markdown"，Claude 就会自动遵循上述所有规则，输出一个完全符合要求的 .md 文件。

这样以后每次写新博客，只需要把 .docx 放进这个文件夹，说一句简单的指令就够了。