# JSON To Markdown Files

> 读取 JSON 文件，将每个属性的值单独保存为 Markdown 文件，文件名为属性名。何时使用：当用户说"把这个JSON转成md文件"、"提取JSON属性为md文件"、"json转markdown文件"或需要从JSON文件提取属性保存为单独md文件时。

- Skill: `steelan9199/json-to-markdown-files` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add steelan9199/json-to-markdown-files`
- Raw SKILL.md: https://api.skillmd.com/api/skills/steelan9199/json-to-markdown-files/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: steelan9199 (https://skillmd.com/u/steelan9199)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/steelan9199/json-to-markdown-files

---


## 🎯 触发映射

| 用户输入触发词                                                         | AI 执行动作        |
| ---------------------------------------------------------------------- | ------------------ |
| "把这个JSON转成md文件" / "提取JSON属性为md文件" / "json转markdown文件" | 按【提取模式】执行 |

## 提取模式

### 执行步骤

注意: 禁止读取文件的具体内容, 因为文件通常很大, 你只需要传递文件路径即可。

| 步骤 | 执行动作           | 具体命令/操作                                                                                                                              |
| ---- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| 1    | 读取并运行提取脚本 | 运行 `RunCommand` 执行 `node scripts/extract-data.js "<json-file-path>"` <br>⚠️ **重要**: 必须用双引号包裹文件路径，因为路径中可能包含空格 |

### 输出结果

**成功时输出示例：**

```
✅ JSON 属性提取成功

📋 生成的文件：
- systemPrompt.md
- userPrompt.md

📝 文件已保存到输入 JSON 文件同级目录, 该目录的绝对路径是: <目录路径>
```

**失败时输出示例：**

```
❌ 提取失败

错误原因：{具体错误信息}
解决建议：请检查 JSON 文件路径和格式是否正确
```

### 错误处理

| 错误场景         | 错误表现                          | 处理方式                                   |
| ---------------- | --------------------------------- | ------------------------------------------ |
| JSON 文件不存在  | ENOENT: no such file or directory | 使用 `LS` 检查文件路径，确认文件存在       |
| JSON 格式错误    | SyntaxError: Unexpected token     | 使用 `Read` 读取文件内容，检查 JSON 格式   |
| 路径引号使用不当 | MODULE_NOT_FOUND / 找不到模块     | 确保用双引号包裹完整文件路径，避免嵌套引号 |

## Resources

- [extract-data.js](scripts/extract-data.js) - JSON 转 Markdown 文件的提取脚本