Markdown格式化工具免费版

Markdown 格式化工具免费版

概述

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

核心能力

1. 内容类型自动识别

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

2. Frontmatter 生成

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

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

3. 格式化工具箱

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

4. 排版修正

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

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

使用场景

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

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

输入格式

# 格式化文章
请格式化文件: 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
}

配置项说明

最佳实践

1. 遵守核心原则

格式化的核心原则:

2. 标题层级规范

# 文档标题 (H1, 仅在 frontmatter 无 title 时)
# ...
## 主要章节 (H2)
# ...
### 子章节 (H3)
# ...
#
### 细节 (H4, 谨慎使用)

3. 摘要写作原则

禁止模式:

• "本文介绍了..."
• 纯主题描述无价值主张
• 用不同词重复标题

常见问题

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+(排版脚本运行)

依赖详情

API Key 配置

• 本工具基于 Markdown 指令驱动,无需额外 API Key
• 排版脚本本地运行,无需联网

可用性分类

• 分类: MD+EXEC+SCRIPT(Markdown 指令 + 命令行执行 + 排版脚本)
• 说明: 通过自然语言指令驱动 Agent 执行格式化,排版修正确环节调用本地脚本
• 离线可用: 是,格式化与排版修正均在本地完成

错误处理

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响
• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

输出格式

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