Skip to content

yinxinhai0128/DocFormatter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📄 DocFormatter - AI文档格式化助手

把AI生成的Markdown内容转换成干净、美观、格式统一的Word/PDF文档

✨ 项目简介

是不是遇到过这些痛点?

  • 🤯 从AI那里复制的内容粘贴到Word里格式全乱了
  • 😫 蓝色标题、灰色代码框、多余的空行、间距乱七八糟
  • 📝 交作业、写报告还要花半小时手动排版

DocFormatter 就是来解决这些问题的!

一键把AI生成的Markdown内容转换成:

  • ✅ 格式统一的Word/PDF文档
  • ✅ 黑色标题(不再是难看的蓝色!)
  • 图形化设置界面 - 点点鼠标就能改所有参数!
  • ✅ 自动设置字体、字号、行距、首行缩进
  • ✅ 自动识别标题层级、列表、表格、代码块、图片
  • ✅ 图形界面,不用敲命令!

🚀 快速开始

运行图形界面(推荐)

python gui.py

然后在界面里:

  1. 粘贴Markdown内容,或者点击"📂 打开Markdown文件"
  2. 点击"⚙️ 设置"按钮可以自定义所有格式参数
  3. 点击"📝 转换为Word"或"📄 转换为PDF"
  4. 选择保存位置,搞定!

命令行使用

python main.py 输入文件.md 输出文件.docx

⚙️ 自定义格式设置

方法一:图形化设置(推荐,最简单)

  1. 点击主界面右上角的"⚙️ 设置"按钮
  2. 在弹出的设置窗口里,直接修改你想要的参数
  3. 点击"💾 保存设置"
  4. 下次生成文档自动使用新设置!

方法二:手动修改配置文件

配置文件位置:config.json(不推荐,用图形界面更方便)


🎨 可自定义的参数

标签页 可设置参数
正文设置 正文字体、字号、行间距、首行缩进、段后间距
标题设置 一级/二级/三级标题的字体、字号
代码块设置 代码块字体、字号、行间距
其他设置 文字颜色(支持颜色选择器)、表格设置、图片设置

🎯 功能特性

✅ 已实现

  • Markdown解析(标题、段落、列表、代码块、表格、图片)
  • 转换为Word文档
  • 转换为PDF文档(需安装Microsoft Word)
  • 图形化设置界面 - 所有参数点点就能改!
  • 统一基本样式:黑色标题、黑色正文、宋体/黑体
  • 自动首行缩进、标准行间距
  • 表格优化显示
  • 代码块等宽字体
  • 支持网络图片和本地图片
  • 支持从剪贴板粘贴
  • 支持打开本地Markdown文件
  • 颜色选择器 - 自定义文字颜色
  • 恢复默认设置功能

📅 计划中

  • 更多高级格式(引用、链接、脚注)
  • 批量转换
  • 对接各大AI平台直接生成
  • 模板库(作业模板、报告模板、论文模板等)

🛠️ 技术栈

  • GUI界面:tkinter(Python内置,无需额外安装)
  • Word文档生成:python-docx
  • PDF文档生成:pywin32(调用Microsoft Word)
  • 无AI调用 - 纯代码处理,完全免费!

📦 安装使用

# 安装基础依赖
pip install python-docx

# 如果需要PDF导出功能(Windows系统)
pip install pywin32

# 运行图形界面(推荐)
python gui.py

📁 项目结构

DocFormatter/
├── README.md
├── config.json          # 配置文件(自动生成)
├── requirements.txt
├── main.py              # 命令行入口
├── gui.py               # 图形界面入口(推荐使用!)
├── src/
│   ├── __init__.py
│   ├── markdown_parser.py     # Markdown解析器
│   ├── word_generator.py      # Word文档生成器
│   ├── pdf_generator.py       # PDF文档生成器
│   └── style_settings.py      # 样式配置管理
└── examples/
    └── test_full.md           # 完整功能测试文件

🤝 开发者

YinXinHai

本项目仅供学习交流使用!

📅 开发日志

v0.5.0 (2026-05-08)

  • ✅ 新增图形化设置界面!
  • ✅ 所有参数都可以在界面上直观修改
  • ✅ 支持颜色选择器自定义文字颜色
  • ✅ 支持恢复默认设置
  • ✅ 设置自动保存到config.json
  • ✅ 优化用户体验,零门槛使用

v0.4.0 (2026-05-08)

  • ✅ 新增完全自定义配置功能
  • ✅ 支持修改字体、字号、行间距、缩进、颜色等所有参数
  • ✅ 配置文件config.json,修改即生效
  • ✅ 优化样式管理模块

v0.3.0 (2026-05-08)

  • ✅ 标题颜色改为黑色(不再是默认的蓝色!)
  • ✅ 加入图片支持(网络图片和本地图片)
  • ✅ 加入PDF格式导出(需安装Microsoft Word)
  • ✅ 优化GUI界面,增加PDF导出按钮

v0.2.0 (2026-05-08)

  • ✅ 新增图形界面GUI
  • ✅ 支持从剪贴板粘贴
  • ✅ 支持打开文件
  • ✅ 简化Markdown解析,去掉外部依赖
  • ✅ 优化表格支持

v0.1.0 (2026-05-08)

  • ✅ 项目启动,创建基础架构
  • ✅ Markdown解析器(标题、段落、列表、代码块、表格)
  • ✅ Word文档生成器
  • ✅ 命令行工具

About

将AI生成的Markdown内容自动转换成格式统一、美观的Word/PDF文档。支持自定义字体、字号、行间距等格式参数,配备友好的图形化界面,无需编程基础即可使用。

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages