markdown-tools

Convert PDFs, Word, PowerPoint, and Confluence exports to Markdown with Windows/WSL path handling.

1.3k|212|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/daymade/claude-code-skills --skill markdown-tools
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-tools
Source: https://github.com/daymade/claude-code-skills/tree/main/markdown-tools
Command: npx skills add https://github.com/daymade/claude-code-skills --skill markdown-tools

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markitdown, markdown, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill converts a variety of documents to Markdown and handles Windows/WSL path conversions, enabling smooth cross-environment content processing.

Core Features & Use Cases

  • Document-to-Markdown conversion (PDF/Word/Confluence exports)
  • Windows-to-WSL path conversion helpers
  • Batch processing and error handling for large batches

Quick Start

  • Convert: markitdown "path/to/document.pdf" > output.md

Frequently Asked Questions about markdown-tools

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

FAQPage Schema
How do I convert PDF and Word documents to Markdown?

Document-to-Markdown conversion uses markitdown to process PDFs, .doc, .docx, and .pptx files into Markdown format. Run `markitdown "path/to/document.pdf" > output.md` to convert a single file, preserving structure and content as valid Markdown suitable for further processing.

Can I convert documents on Windows and use them in WSL?

Windows-to-WSL path conversion is handled by the convert_path.py utility, which normalizes Windows file paths to WSL-compatible formats. This enables seamless cross-environment workflows when moving converted Markdown files between Windows and Linux subsystems.

Does this work for batch processing multiple documents?

Batch processing is supported for large document collections with error handling built in. The Skill preserves directory structure and handles quoted paths and UTF-8 encoding across multiple files, making it suitable for converting knowledge bases and document repositories at scale.

What file formats can be converted to Markdown?

Supported formats for Markdown conversion include PDF, Word (.doc and .docx), PowerPoint (.pptx), and Confluence exports. Each format is processed through markitdown to extract content and structure into clean, convertible Markdown output.

How does path handling work with quoted file paths?

The Skill handles quoted paths and special characters in filenames, automatically normalizing them during Windows-to-WSL conversion. This prevents path resolution errors and ensures compatibility across both environments without manual path editing.