doc-cleaner

Convert PDFs and Office documents into structured Markdown with YAML frontmatter.

307|40|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/notoriouslab/doc-cleaner --skill doc-cleaner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-cleaner
Source: https://github.com/notoriouslab/doc-cleaner/tree/main
Command: npx skills add https://github.com/notoriouslab/doc-cleaner --skill doc-cleaner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires dmgbuild, and includes scripts (resource) components.

What problem does it solve?

Convert documents into clean, structured Markdown offline.

Core Features & Use Cases

It applies to PDFs, Office formats, Keynote/Numbers, and more, preserving tables and enabling privacy-first, local processing. It uses PyMuPDF, python-docx, and pandas locally with optional AI backends, and outputs per-file Markdown with YAML frontmatter.

Quick Start

Install dependencies and run the CLI against your documents to generate Markdown outputs.

Frequently Asked Questions about doc-cleaner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert PDF to Markdown locally without uploading files to the cloud?

You can convert PDFs to clean Markdown offline using local libraries like PyMuPDF. This ensures privacy-first document processing by keeping all file data on your machine and outputs per-file Markdown with YAML frontmatter.

Can I extract tables from Office documents and preserve them in Markdown?

Yes, converting Office formats to Markdown preserves table structures during extraction. The tool uses python-docx and pandas locally to process files and retains table formatting within the structured Markdown output.

Does local document processing support Keynote and Numbers files?

Local document processing supports Keynote and Numbers formats alongside PDFs and Office documents. It converts these formats into structured Markdown offline, maintaining privacy without requiring cloud uploads.

What is the best way to batch convert Office docs to Markdown with YAML frontmatter?

The best way to batch convert Office docs is running a local CLI against your documents. It processes each file into clean Markdown with YAML frontmatter using python-docx and pandas, generating organized outputs for every file.

Do I need an AI backend to convert documents to structured Markdown?

You do not need an AI backend to convert documents to structured Markdown. The tool uses local libraries like PyMuPDF and python-docx by default, with AI backends being entirely optional for enhanced processing.

Why does offline document conversion output per-file Markdown instead of a single file?

Offline document conversion outputs per-file Markdown to maintain clear source mapping and structured organization. Each document gets its own Markdown file with YAML frontmatter, making large batches of converted files easier to manage.