Markdown 格式化工具免费版

概述

Markdown 格式化工具免费版帮助个人用户将纯文本或已有 Markdown 文件转换为结构清晰、读者友好的格式。工具的核心原则是:只调整格式和修正明显错别字,绝不增删或改写内容. 免费版聚焦单文件处理,提供内容分析、格式优化、排版修正三步流程,适合个人博客、技术笔记等场景.

核心能力

1. 内容类型自动识别

指标	判定结果
包含 --- YAML frontmatter	Markdown
包含 #、##、### 标题	Markdown
包含 **bold**、列表、代码块	Markdown
以上均无	纯文本

处理: 解析内容类型自动识别的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回内容类型自动识别的响应数据,包含状态码、结果和日志.

2. Frontmatter 生成

自动为文档生成 YAML frontmatter,包含以下字段:

字段	说明
title	文档标题(交互式选择)
slug	从文件名或标题推断
summary	一句话摘要(50-80字)
description	详细描述(100-200字)

处理: 解析Frontmatter 生成的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回Frontmatter 生成的响应数据,包含状态码、结果和日志.

3. 格式化工具箱

元素	适用场景	格式
标题	主题边界、章节分隔	##、### 层级
加粗	关键结论、核心要点	**加粗**
无序列表	平行项、特性清单	- 项
有序列表	步骤、排名、流程	1. 项
表格	对比、结构化数据	Markdown 表格
代码	命令、路径、技术术语	`内联` 或代码块
引用	名言、重要警告	> 引用

处理: 解析格式化工具箱的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回格式化工具箱的响应数据,包含状态码、结果和日志.

4. 排版修正

• 中英文混排自动加空格
• 修正 CJK 强调标点问题
• 格式化 frontmatter YAML

处理: 解析排版修正的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回排版修正的响应数据,包含状态码、结果和日志. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：将纯文本或、文件转换为结构清、易读的格式、支持标题、列表优化、面向个人用户的、将纯文本或已有、转换为结构清晰、核心能力、自动识别纯文本与、优化标题层级、加粗关键结论、列表化平行内容、中英文混排间距自、动修正等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景一: 博客文章格式整理

作者完成文章初稿后,使用本工具优化结构. 用户可通过自然语言指令触发此场景，工具将自动执行相应操作并返回结构化结果.

输入格式

参数名	类型	必填	说明
input	string	是	Markdown格式化工具免费版处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

# 格式化文章
请格式化文件: posts/my-article.md
模式: 优化格式(推荐)
输出: posts/my-article-formatted.md

处理流程:

输入: 纯文本或未优化的 Markdown
  ↓
分析: 提取关键结论、识别结构问题
  ↓
格式化: 添加标题、加粗、列表、表格
  ↓
排版修正: 中英文间距、标点修正
  ↓
输出: my-article-formatted.md

场景二: 技术笔记结构化

将零散的技术笔记整理为有层级的文档.

# 格式化笔记
请格式化文件: notes/docker-tips.txt
检测: 纯文本
目标: 转换为结构化 Markdown
输出: notes/docker-tips-formatted.md

场景三: 文档可读性提升

已有 Markdown 文档的排版优化.

# 仅修正排版(保留原结构)
请对文件 docs/api.md 执行排版修正
模式: 仅排版修正
修正项: 中英文间距、标点
输出: 直接修改原文件

不适用场景

以下场景Markdown格式化工具免费版不适合处理：

• 加密文件破解
• 损坏文件修复
• 物理介质数据恢复

触发条件

需要文件处理、文档转换、格式互转、内容提取时使用。不适用于非本工具能力范围的需求.

快速开始

第一步: 准备文件

确保待格式化的文件存在,支持 .md 和 .txt 格式.

第二步: 触发格式化

# 基本用法
请格式化文件 article.md
# ...
# 指定输出
请格式化文件 article.md,输出为 article-formatted.md
# ...
# 仅排版修正
请对 article.md 执行排版修正,直接修改原文件

第三步: 选择标题(交互式)

工具会生成 4-5 个标题候选,用户选择或自定义:

请选择标题:
1. [钩子标题A] - (推荐) [公式名]
2. [钩子标题B] - [公式名]
3. [直接标题C] - 直接描述
4. [直接标题D] - 直接描述
输入编号,或输入自定义标题:

第四步: 查看完成报告

格式化完成
# ...
文件:
- 分析: article-analysis.md
- 格式化: article-formatted.md
# ...
变更摘要:
- Frontmatter: 已添加(title, slug, summary)
- 标题: 新增 5 个(##: 3, ###: 2)
- 加粗: 8 处
- 列表: 3 个(从段落转换)
- 排版修正: 中英文间距已修正

示例

基础配置

在项目根目录创建 .format-config.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. 标题层级规范

# 文档标题 (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环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响
• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

输出格式

{
  "success": true,
  "data": {
    "result": "Markdown格式化工具免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "markdown format"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}