markdown-converter

Convert PDFs, Word docs, HTML, and images into Markdown using pdfplumber and PyMuPDF.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/sunLeee/optimization --skill markdown-converter-sunleee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-converter
Source: https://github.com/sunLeee/optimization/tree/main/.claude/skills/data-fetch/markdown-converter
Command: npx skills add https://github.com/sunLeee/optimization --skill markdown-converter-sunleee

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Converting external documents (PDF, DOCX, HTML, images) into Markdown for reference documentation.

Core Features & Use Cases

  • Converts PDFs, Word documents, HTML pages, and images into clean Markdown for easy reference.
  • Preserves structure like headings, paragraphs, tables, and image references for design docs.
  • Output is stored under docs/references to support design system documentation.

Quick Start

Run the converter with the input file path and optional output path to generate a Markdown document under docs/references.

Frequently Asked Questions about markdown-converter

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

FAQPage Schema
How do I convert PDFs and Word documents to Markdown for reference documentation?

You can convert PDFs and Word documents to Markdown by running a Python-based workflow that uses pdfplumber and PyMuPDF backends to extract text and tables, generating clean Markdown files under docs/references.

Can I extract tables from PDF files and preserve them in Markdown?

Yes, you can extract tables from PDF files and preserve them in Markdown. The conversion process uses pdfplumber and PyMuPDF backends specifically to extract text and tables while maintaining structural elements like headings and paragraphs.

Does this PDF to Markdown converter support HTML pages and images?

Yes, the converter supports HTML pages and images alongside PDF and DOCX files. It transforms these external document formats into portable Markdown that preserves structure for embedding in design system documentation.

What is the best way to generate design-reference documentation from external files?

The best way to generate design-reference documentation from external files is converting them into portable Markdown. This approach preserves structural elements like headings, tables, and image references, storing outputs under docs/references for design specs.

Do I need Python dependencies to convert PDF documents to Markdown format?

Yes, you need Python dependencies to convert PDF documents to Markdown format. The workflow relies on the pdfplumber and PyMuPDF libraries to process external documents, extract text, and generate the final Markdown output.

What are the limitations of using pdfplumber and PyMuPDF for document conversion?

When using pdfplumber and PyMuPDF for document conversion, limitations may arise from complex layouts or scanned images, as these backends focus primarily on extracting text and tables into Markdown rather than performing OCR on image-based PDFs.