Joe's Markdown to DOCX Converter

Other

Convert Markdown files to fully formatted Word DOCX documents with support for tables, images, code blocks, and GitHub Flavored Markdown features.

Install

openclaw skills install joe-markdown-to-docx

Markdown to DOCX Converter

Convert Markdown documents to professional Word DOCX format with full formatting preservation.

Features

✅ Complete Markdown support: Headers, paragraphs, lists, code blocks
✅ Tables: Full table support with alignment (left/center/right)
✅ Images: Local files, remote URLs, and data URLs
✅ Text formatting: Bold, italic, inline code, links
✅ Code blocks: Syntax-highlighted with borders and background
✅ GFM support: GitHub Flavored Markdown extensions

Installation

After installing this skill, run:

cd ~/.openclaw/workspace/skills/markdown-to-docx
npm install

All dependencies are pure JavaScript and work on Windows, macOS, and Linux.

Usage

Convert a Markdown file to DOCX:

node scripts/convert.js <input.md> [output.docx]

Examples

# Convert with auto-generated output name
node scripts/convert.js document.md

# Specify output filename
node scripts/convert.js document.md report.docx

# Convert from current directory
node scripts/convert.js ./README.md ./README.docx

Supported Markdown Features

Text Formatting

Bold: **text** or __text__
Italic: *text* or _text_
Inline code: `code`
Links: [text](url)

Tables

| Header 1 | Header 2 | Header 3 |
|:---------|:--------:|---------:|
| Left     | Center   | Right    |

Alignment: :--- (left), :---: (center), ---: (right)
Header row with gray background
Bordered cells with padding

Images

![Alt text](path/to/image.png)
![Remote](https://example.com/image.jpg)

Local images: Relative paths from Markdown file location
Remote images: HTTP/HTTPS URLs (automatically downloaded)
Data URLs: Base64-encoded images
Auto-centered with appropriate sizing

Code Blocks

```javascript
function hello() {
  console.log("Hello!");
}
```

Monospace font (Consolas)
Light gray background
Border styling

Output Format

Generated DOCX files include:

1-inch margins on all sides
Professional spacing and alignment
Consistent styling throughout
Editable in Microsoft Word, Google Docs, LibreOffice

Error Handling

Missing images: Shows placeholder text instead of breaking
Network errors: Graceful fallback with error message
Invalid Markdown: Skips unsupported elements

Dependencies

Automatically installed via npm install:

docx: Word document generation
unified, remark-parse, remark-gfm: Markdown parsing
node-fetch: Remote image downloading