Markdown Format Tool Free

将纯文本或Markdown文件转换为结构清晰、易读的格式,支持标题、摘要、列表优化

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