skills.rest
zhizhunbao
zhizhunbaoCOMMUNITY
Explore all skills by this author →
GitHub

docx-to-md

Converts Microsoft Word .docx files to Markdown .md preserving formatting and images.

Updated Jan 28, 2026
Search Tags:#markdown#pandoc#conversion#docx#document#mammoth
One-click install
npx skills add https://github.com/zhizhunbao/ai-dev-config --skill docx-to-md-zhizhunbao
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: docx-to-md
Source: https://github.com/zhizhunbao/ai-dev-config/tree/main/core/skills/dev-docx_to_md
Command: npx skills add https://github.com/zhizhunbao/ai-dev-config --skill docx-to-md-zhizhunbao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mammoth, pandoc, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the conversion of Microsoft Word documents (.docx) into Markdown (.md) format, preserving formatting and images.

Core Features & Use Cases

  • Format Preservation: Converts headings, lists, tables, bold, and italic text.
  • Image Extraction: Extracts and saves embedded images.
  • Batch Conversion: Handles multiple .docx files efficiently.
  • Use Case: Convert a project proposal document from .docx to .md for easy integration into a Markdown-based documentation system or wiki.

Quick Start

Use the docx-to-md skill to convert the file 'report.docx' to 'report.md'.

Frequently Asked Questions about docx-to-md

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

FAQPage Schema
How do I convert Word documents to Markdown while preserving formatting?▼

Converting Word documents to Markdown while preserving formatting is achieved by extracting .docx elements like headings, lists, and tables into corresponding .md syntax.

Does converting docx to markdown extract embedded images?▼

Yes, converting docx to markdown extracts embedded images. The process saves embedded images from the Word document and manages image path relativity during the transformation.

Can I batch convert multiple docx files to markdown?▼

Yes, you can batch convert multiple docx files to markdown. The process handles multiple .docx files efficiently, enabling simultaneous document processing.

How do Pandoc and Mammoth handle character encoding issues during docx conversion?▼

Pandoc and Mammoth handle character encoding issues during docx conversion by applying template-based transformations and scripts to resolve common formatting and encoding anomalies.

What is the best way to convert a project proposal from docx for a wiki?▼

The best way to convert a project proposal from docx for a wiki is to transform the .docx file into .md format, ensuring seamless integration into a Markdown-based documentation system.

Related Skills

Explore More Software Engineering Skills→
jykimjykim
1

markdown-to-docx

Convert Markdown documents to .docx with Korean font support and inline formatting.

Community
Intermediate
microsoftmicrosoft
2.9k

wiki-vitepress

Package wiki Markdown into a VitePress static site with dark theme and Mermaid diagrams.

Official
Advanced
texiaoyaotexiaoyao
6

office-automation

Automate Word and Excel template filling, data extraction, and batch processing.

Community
Intermediate
cas-bigdatalabcas-bigdatalab
541

docx_text_extract

Extract text from DOCX files to plain text using Python's zipfile and xml libraries.

Official
Basic