back
loading skill details...
将纯文本或Markdown文件转换为结构清晰、易读的格式,支持标题、摘要、列表优化
---
name: "markdown-format-tool-free"
description: "将纯文本或Markdown文件转换为结构清晰、易读的格式,支持标题、摘要、列表优化"
license: Proprietary
allowed-tools: read exec
compatibility: "Requires LLM with tool-use capability"
metadata:
displayName: "Markdown格式化工具免费版"
version: "1.0.0"
summary: "将纯文本或Markdown文件转换为结构清晰、易读的格式,支持标题、摘要、列表优化"
tags:
- "文档工具"
- "Markdown"
- "格式化"
- "排版"
source: "SkillHub"
converted_at: "2026-07-22T17:58:36"
---
# Markdown 格式化工具免费版
## 概述
Markdown 格式化工具免费版帮助个人用户将纯文本或已有 Markdown 文件转换为结构清晰、读者友好的格式。工具的核心原则是:只调整格式和修正明显错别字,绝不增删或改写内容。
免费版聚焦单文件处理,提供内容分析、格式优化、排版修正三步流程,适合个人博客、技术笔记等场景。
## 核心能力
### 1. 内容类型自动识别
| 指标 | 判定结果 |
|:-----|:---------|
| 包含 `---` YAML frontmatter | Markdown |
| 包含 `#`、`##`、`###` 标题 | Markdown |
| 包含 `**bold**`、列表、代码块 | Markdown |
| 以上均无 | 纯文本 |
**输入**: 用户提供内容类型自动识别所需的指令和必要参数。
**处理**: 按照skill规范执行内容类型自动识别操作,遵循单一意图原则。
**输出**: 返回内容类型自动识别的执行结果,包含操作状态和输出数据。
### 2. Frontmatter 生成
自动为文档生成 YAML frontmatter,包含以下字段:
| 字段 | 说明 |
|:-----|:-----|
| `title` | 文档标题(交互式选择) |
| `slug` | 从文件名或标题推断 |
| `summary` | 一句话摘要(50-80字) |
| `description` | 详细描述(100-200字) |
**输入**: 用户提供Frontmatter 生成所需的指令和必要参数。
**处理**: 按照skill规范执行Frontmatter 生成操作,遵循单一意图原则。
**输出**: 返回Frontmatter 生成的执行结果,包含操作状态和输出数据。
### 3. 格式化工具箱
| 元素 | 适用场景 | 格式 |
|:-----|:---------|:-----|
| 标题 | 主题边界、章节分隔 | `##`、`###` 层级 |
| 加粗 | 关键结论、核心要点 | `**加粗**` |
| 无序列表 | 平行项、特性清单 | `- 项` |
| 有序列表 | 步骤、排名、流程 | `1. 项` |
| 表格 | 对比、结构化数据 | Markdown 表格 |
| 代码 | 命令、路径、技术术语 | `` `内联` `` 或代码块 |
| 引用 | 名言、重要警告 | `> 引用` |
**输入**: 用户提供格式化工具箱所需的指令和必要参数。
**处理**: 按照skill规范执行格式化工具箱操作,遵循单一意图原则。
**输出**: 返回格式化工具箱的执行结果,包含操作状态和输出数据。
### 4. 排版修正
- 中英文混排自动加空格
- 修正 CJK 强调标点问题
- 格式化 frontmatter YAML
**输入**: 用户提供排版修正所需的指令和必要参数。
**处理**: 按照skill规范执行排版修正操作,遵循单一意图原则。
**输出**: 返回排版修正的执行结果,包含操作状态和输出数据。
**能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：将纯文本或、文件转换为结构清、易读的格式、支持标题、列表优化、面向个人用户的、将纯文本或已有、转换为结构清晰、核心能力、自动识别纯文本与、优化标题层级、加粗关键结论、列表化平行内容、中英文混排间距自、动修正等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。
## 使用场景
### 场景一: 博客文章格式整理
作者完成文章初稿后,使用本工具优化结构。
```bash
# 格式化文章
请格式化文件: posts/my-article.md
模式: 优化格式(推荐)
输出: posts/my-article-formatted.md
```
处理流程:
```text
输入: 纯文本或未优化的 Markdown
↓
分析: 提取关键结论、识别结构问题
↓
格式化: 添加标题、加粗、列表、表格
↓
排版修正: 中英文间距、标点修正
↓
输出: my-article-formatted.md
```
### 场景二: 技术笔记结构化
将零散的技术笔记整理为有层级的文档。
```bash
# 格式化笔记
请格式化文件: notes/docker-tips.txt
检测: 纯文本
目标: 转换为结构化 Markdown
输出: notes/docker-tips-formatted.md
```
### 场景三: 文档可读性提升
已有 Markdown 文档的排版优化。
```bash
# 仅修正排版(保留原结构)
请对文件 docs/api.md 执行排版修正
模式: 仅排版修正
修正项: 中英文间距、标点
输出: 直接修改原文件
```
## 不适用场景
以下场景Markdown格式化工具免费版不适合处理：
- 加密文件破解
- 损坏文件修复
- 物理介质数据恢复
## 触发条件
需要文件处理、文档转换、格式互转、内容提取时使用。不适用于非本工具能力范围的需求。
## 快速开始
### 第一步: 准备文件
确保待格式化的文件存在,支持 `.md` 和 `.txt` 格式。
### 第二步: 触发格式化
```bash
# 基本用法
请格式化文件 article.md
# 指定输出
请格式化文件 article.md,输出为 article-formatted.md
# 仅排版修正
请对 article.md 执行排版修正,直接修改原文件
```
### 第三步: 选择标题(交互式)
工具会生成 4-5 个标题候选,用户选择或自定义:
```text
请选择标题:
1. [钩子标题A] - (推荐) [公式名]
2. [钩子标题B] - [公式名]
3. [直接标题C] - 直接描述
4. [直接标题D] - 直接描述
输入编号,或输入自定义标题:
```
### 第四步: 查看完成报告
```text
格式化完成
文件:
- 分析: article-analysis.md
- 格式化: article-formatted.md
变更摘要:
- Frontmatter: 已添加(title, slug, summary)
- 标题: 新增 5 个(##: 3, ###: 2)
- 加粗: 8 处
- 列表: 3 个(从段落转换)
- 排版修正: 中英文间距已修正
```
## 示例
### 基础配置
在项目根目录创建 `.format-config.json` 自定义默认行为:
```json
{
"auto_select": false,
"auto_select_title": false,
"auto_select_summary": false,
"quotes": false,
"spacing": true,
"emphasis": true
}
```
### 配置项说明
| 配置项 | 可选值 | 默认值 | 说明 |
|:-------|:-------|:-------|:-----|
| `auto_select` | true/false | false | 跳过所有选择,自动取最优 |
| `auto_select_title` | true/false | false | 跳过标题选择 |
| `auto_select_summary` | true/false | false | 跳过摘要选择 |
| `quotes` | true/false | false | ASCII 引号转全角 |
| `spacing` | true/false | true | 中英文间距修正 |
| `emphasis` | true/false | true | CJK 强调标点修正 |
## 最佳实践
### 1. 遵守核心原则
格式化的核心原则:
| 该做 | 不该做 |
|:-----|:-------|
| 保留作者语气和每个词 | 不添加句子或注释 |
| 加粗关键结论 | 不删除或缩短内容 |
| 平行项提取为列表 | 不改写作者原文 |
| 对比数据转为表格 | 不加主观性标题 |
| 修正明显错别字 | 不过度格式化 |
### 2. 标题层级规范
```markdown
# 文档标题 (H1, 仅在 frontmatter 无 title 时)
## 主要章节 (H2)
### 子章节 (H3)
#### 细节 (H4, 谨慎使用)
```
### 3. 摘要写作原则
| 原则 | 说明 |
|:-----|:-----|
| 传达核心价值 | 不只是描述主题 |
| 使用具体细节 | 数字、结果、方法 |
| summary 简洁有力 | 50-80 字,自包含 |
| description 可展开 | 100-200 字,含支撑细节 |
**禁止模式:**
- "本文介绍了..."
- 纯主题描述无价值主张
- 用不同词重复标题
## 常见问题
### Q1: 免费版支持批量格式化吗?
不支持。免费版一次处理一个文件。如需批量处理,请使用 PRO 版。
### Q2: 格式化会修改原文内容吗?
不会。工具只调整格式和修正明显错别字,绝不增删或改写内容。
### Q3: 支持哪些文件格式?
支持纯文本(`.txt`)和 Markdown(`.md`)文件。输出统一为 Markdown 格式。
### Q4: 中英文混排间距如何处理?
默认自动在中英文之间添加空格,可通过配置 `spacing: false` 关闭。
### Q5: 生成的标题不满意怎么办?
标题选择是交互式的,可以输入自定义标题替代候选选项。
## 依赖说明
### 运行环境
- **Agent 平台**: 支持读取 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
- **操作系统**: Windows / macOS / Linux
- **Node.js**: 16+(排版脚本运行)
### 依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-------|:-----|:---------|:---------|
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |
| Node.js | 运行时 | 排版脚本必需 | nodejs.org |
| bun(可选) | 运行时 | 否 | bun.sh |
### API Key 配置
- 本工具基于 Markdown 指令驱动,无需额外 API Key
- 排版脚本本地运行,无需联网
### 可用性分类
- **分类**: MD+EXEC+SCRIPT(Markdown 指令 + 命令行执行 + 排版脚本)
- **说明**: 通过自然语言指令驱动 Agent 执行格式化,排版修正确环节调用本地脚本
- **离线可用**: 是,格式化与排版修正均在本地完成
## 错误处理
| 错误场景 | 原因 | 处理方式 |
|---------|------|---------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |
## 已知限制
- 需LLM支持,无LLM环境不可用
- 复杂业务场景建议结合人工经验判断
- 执行效率受模型能力与网络环境影响
- 当前为免费版本,如需完整功能请升级到付费版获取全部能力don't have the plugin yet? install it then click "run inline in claude" again.