docx-to-markdown

Convert Microsoft Word .docx files to Markdown using the markitdown CLI.

2|2|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/srulyt/srulys-agent-packs --skill docx-to-markdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docx-to-markdown
Source: https://github.com/srulyt/srulys-agent-packs/tree/main/agent-packs/spec-creator/.roo/skills/docx-to-markdown
Command: npx skills add https://github.com/srulyt/srulys-agent-packs --skill docx-to-markdown

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the conversion of Microsoft Word (.docx) documents into Markdown format, making them easily readable and processable by LLMs and text-based tools.

Core Features & Use Cases

  • Seamless Conversion: Converts .docx files to .md format using the markitdown CLI.
  • Flexible Output: Allows specifying custom output paths or defaults to the same directory as the source file.
  • Use Case: Convert research papers, reports, or articles originally written in Word into Markdown for easy integration into documentation sites, wikis, or content management systems.

Quick Start

Convert the file 'my_document.docx' to Markdown using the default output location.

Frequently Asked Questions about docx-to-markdown

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

FAQPage Schema
How do I convert a Word document to Markdown?

To convert a Word document to Markdown, this Skill uses the markitdown command-line tool to transform .docx files into .md format. It automates text extraction, allowing you to specify custom output paths or default to the source directory.

What is the best way to extract text from a DOCX file for a wiki?

The best way to extract text from a DOCX file for a wiki is converting it to Markdown format. This Skill translates Word documents into Markdown, making the content easily readable and ready for integration into documentation sites and content management systems.

Do I need Python to convert DOCX files to Markdown?

Yes, you need Python 3.10 or higher to convert DOCX files to Markdown using this Skill. The conversion requires the markitdown package with docx support installed in your environment to process the Word documents.

Can I specify a custom output path when converting DOCX to Markdown?

Yes, you can specify a custom output path when converting DOCX to Markdown. If no custom path is provided, the Skill defaults to saving the generated .md file in the same directory as the source .docx file.

Does the DOCX to Markdown conversion handle file validation errors?

Yes, the DOCX to Markdown conversion handles file validation and error reporting. If the markitdown CLI encounters issues processing the Word document, the Skill reports the error to ensure you are aware of any conversion failures.