# Markdown To DOCX

> Convert markdown documents to Microsoft Word (.docx) format with Korean font support, bold/italic formatting, nested list indentation, and professional styling

- Skill: `jykim/markdown-to-docx` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add jykim/markdown-to-docx`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jykim/markdown-to-docx/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: jykim (https://skillmd.com/u/jykim)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jykim/markdown-to-docx

---


# Markdown to DOCX Converter

Convert markdown documents to professionally formatted Microsoft Word (.docx) files with full support for Korean text, inline formatting, and nested lists.

## When to Use This Skill

Use this skill when you need to:
- Convert markdown documents to Word format for sharing or editing
- Create DOCX files with proper Korean font rendering
- Preserve formatting like bold, italic, headers, and lists
- Export vault notes to Word documents
- Generate professional documents from markdown content

**Trigger phrases:**
- "Convert this markdown to DOCX"
- "Export [filename].md to Word"
- "Create a Word document from this markdown"
- "Generate DOCX from [filename]"

## Features

### ✅ Korean Language Support
- Default font: **Malgun Gothic** (맑은 고딕)
- Proper rendering of Korean characters
- Mixed Korean/English text support

### ✅ Inline Formatting
- **Bold text**: `**text**` or `__text__`
- *Italic text*: `*text*` or `_text*`
- Preserves formatting in headers, lists, and paragraphs

### ✅ Nested List Support
- Bullet lists with proper indentation
- Numbered lists with hierarchy
- Automatic indent calculation (2 spaces = 0.5 inch)
- Checkbox support: `- [ ]` and `- [x]`

### ✅ Document Structure
- Headers: H1, H2, H3, H4
- Block quotes with indentation
- Regular paragraphs
- Comment filtering (`%%comment%%`)

## How It Works

1. **Parse Markdown**: Reads markdown content line by line
2. **Process Structure**: Identifies headers, lists, quotes, paragraphs
3. **Apply Formatting**: Converts markdown syntax to DOCX formatting
4. **Set Fonts**: Applies Korean-friendly fonts throughout
5. **Generate File**: Creates .docx file ready for Word/Google Docs

## Usage Examples

### Example 1: Convert Korean Document
```
"Convert this markdown to DOCX:

# 한국어 문서 제목

## 소개
이것은 **굵은 글씨**이고 이것은 *기울임*입니다.

- 항목 1
  - 중첩된 항목
- 항목 2"
```

### Example 2: Export Vault Note
```
"Export 'Publish/AI for Better Me/AI for Better Me - FastCampus Class.md' to DOCX"
```

### Example 3: Mixed Language Content
```
"Create a Word document from this:

# AI for PKM

## Core Concepts
- **지식 관리** (Knowledge Management)
  - Information capture
  - 자동 정리 (Auto-organization)
- AI Integration"
```

## Supported Markdown Elements

| Markdown Syntax | DOCX Output | Notes |
|----------------|-------------|-------|
| `# Heading 1` | Heading Level 1 | H1 style |
| `## Heading 2` | Heading Level 2 | H2 style |
| `### Heading 3` | Heading Level 3 | H3 style |
| `**bold**` | **Bold text** | Run-level formatting |
| `*italic*` | *Italic text* | Run-level formatting |
| `- Item` | • Bullet list | List Bullet style |
| `  - Nested` | ◦ Indented bullet | 0.5" indent |
| `1. Item` | 1. Numbered list | List Number style |
| `- [ ]` | ☐ Checkbox | Unchecked |
| `- [x]` | ☑ Checkbox | Checked |
| `> Quote` | Indented quote | Italic, 0.5" indent |
| `%%comment%%` | (removed) | Filtered out |

## Technical Details

### Font Configuration
- **Default**: Malgun Gothic (11pt)
- Applied to all runs and paragraphs
- Consistent rendering across Korean/English

### Indentation Rules
- Base indent: 0.5 inches per level
- Calculated from leading spaces (2 spaces = 1 level)
- Applies to both bullet and numbered lists

### Processing Steps
```python
# Main workflow
1. Read markdown file or content
2. Skip YAML frontmatter (---...---)
3. Process each line:
   - Detect type (header, list, paragraph)
   - Calculate indent level
   - Apply inline formatting (bold/italic)
   - Create DOCX element with proper style
4. Save to .docx file
```

## Scripts

### docx_generator.py
Main conversion script with:
- `DOCXGenerator` class for document creation
- `process_inline_formatting()` for **bold** and *italic*
- `get_indent_level()` for nested list calculation
- `create_docx_from_markdown()` entry point

## Tips for Best Results

1. **Clean Frontmatter**: The converter skips YAML frontmatter automatically
2. **Consistent Spacing**: Use 2 spaces for each indentation level
3. **List Markers**: Use `-` for bullets, `1.` for numbers
4. **Korean Text**: No special handling needed - just write normally
5. **File Size**: Works well with documents up to ~500 lines

## Limitations

- Does not support tables (requires complex DOCX table API)
- Images are not embedded (wiki links are preserved as text)
- Internal links (`[[wikilinks]]`) rendered as plain text
- Code blocks rendered as regular paragraphs

## Output Format

Generated DOCX files include:
- Professional document styling
- Proper heading hierarchy
- Consistent font throughout (Malgun Gothic)
- Preserved formatting and structure
- Ready for Microsoft Word, Google Docs, LibreOffice

## Example Output Structure

```
Document Properties:
├── Default Font: Malgun Gothic 11pt
├── Page Size: Letter (8.5" × 11")
└── Margins: Normal (1" all sides)

Content Hierarchy:
├── Heading 1 (Title level)
├── Heading 2 (Section)
│   ├── Paragraph with bold/italic
│   ├── Bullet List
│   │   └── Nested Bullet (indented)
│   └── Numbered List
└── Heading 2 (Next section)
```

## Dependencies

Requires `python-docx` library:
```bash
pip install python-docx>=1.1.0
```

## Related Skills

- **csv-analysis**: Analyze CSV files and export to Excel
- **pdf-skill**: Work with PDF documents
- **claude-epub-skill**: Convert markdown to EPUB format