word-markdown-converter

Convert Word documents to Markdown and back with style preservation.

Updated Jun 21, 2023
One-click install
npx skills add https://github.com/kynoptic/wikipedia-reliable-sources --skill word-markdown-converter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: word-markdown-converter
Source: https://github.com/kynoptic/wikipedia-reliable-sources/tree/main/.claude/skills/word-markdown-converter
Command: npx skills add https://github.com/kynoptic/wikipedia-reliable-sources --skill word-markdown-converter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-docx, pyyaml, marko, pandoc, and includes scripts (resource) components.

What problem does it solve?

This tool enables seamless, high-fidelity conversion between Word documents and Markdown, preserving styles, structure, and round-trip fidelity to streamline authoring and publishing workflows.

Core Features & Use Cases

  • Bidirectional conversion between Word and Markdown with high-fidelity style preservation.
  • Automatic image extraction, YAML frontmatter generation, and configurable style mappings.
  • Use Case: publish Word-originated content in Markdown for Markdown-based sites and convert Markdown back to Word for editing in Word.

Quick Start

Convert a Word document to Markdown by running the converter with the input file as the argument.

Frequently Asked Questions about word-markdown-converter

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 and styles?

You can convert Word documents to Markdown by running the Python-based converter with your input file. It preserves formatting and styles using YAML frontmatter-driven style maps and Pandoc-based fidelity for high-accuracy output.

Can I convert Markdown back to Word and maintain round-trip editing fidelity?

Yes, this converter supports bidirectional Markdown-to-Word conversion. It maintains round-trip editing fidelity by preserving structural elements like headings, lists, tables, code blocks, images, and hyperlinks across both formats.

Does the Word to Markdown converter extract images and handle YAML frontmatter?

Yes, the Word to Markdown converter supports automatic image extraction and YAML frontmatter generation. This ensures that visual assets and document metadata are correctly translated and mapped during the conversion process.

What is the best way to batch convert Word files to Markdown for static sites?

The best way to batch convert Word files for Markdown-based sites is using this tool's batch workflow capabilities. It handles end-to-end conversion requirements, automatically applying configurable style mappings to streamline authoring and publishing.

Do I need Pandoc and python-docx to run the Word Markdown converter?

Yes, you need Pandoc, python-docx, PyYAML, and marko installed. These dependencies power the underlying conversion logic, enabling high-fidelity style preservation and structural translation between Word and Markdown formats.

How do style mappings work when translating Word documents to Markdown?

Style mappings work by using YAML frontmatter to define configurable rules that translate Word document styles into Markdown elements. This ensures high-fidelity preservation of headings, lists, tables, and other formatting during conversion.