markdown-converter

Convert source files into Markdown using the markitdown command.

8|4|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/jscraik/Agent-Skills --skill markdown-converter-jscraik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-converter
Source: https://github.com/jscraik/Agent-Skills/tree/main/utilities/markdown-converter
Command: npx skills add https://github.com/jscraik/Agent-Skills --skill markdown-converter-jscraik

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the conversion of various document formats (like PDF, DOCX) into clean, structured Markdown, saving time and ensuring consistency compared to manual copy-pasting.

Core Features & Use Cases

  • Format Transformation: Converts documents into Markdown, preserving structure like headings, tables, and links.
  • Repeatable Workflow: Provides a reliable markitdown command for consistent conversions.
  • Use Case: You have a technical specification document in DOCX format and need to convert it into a Markdown file for your project's documentation site.

Quick Start

Use the markdown-converter skill to turn the file 'report.docx' into 'report.md'.

Frequently Asked Questions about markdown-converter

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

FAQPage Schema
How do I convert a PDF to Markdown format?

You can convert a DOCX file to Markdown by specifying the source file path; the conversion workflow automatically extracts the document structure and outputs a structured Markdown file.

What is the best way to extract document structure into Markdown?

Using an automated conversion workflow ensures consistent Markdown extraction by systematically parsing document elements like headings and tables, resulting in clean Markdown output.

Can I convert files from a URL to Markdown?

You can convert files from a URL to Markdown by specifying the URL as the source input; the converter workflow fetches the document and outputs a clean Markdown file.

Does the markdown converter preserve tables and links from DOCX files?

The markdown converter preserves structural elements like tables, links, and headings from DOCX files during format transformation, ensuring structural consistency in the Markdown output.

How do I specify the output path when converting a document to Markdown?

You can specify an output path by providing it as an optional parameter alongside the source file path, ensuring the converted Markdown file is saved to the exact desired location.

What are the limitations of converting PDF documents to Markdown?

Limitations of converting PDF documents to Markdown include potential loss of complex formatting or embedded media, as the converter focuses on extracting text and basic structural elements into Markdown format.