Presets Reference

md2docx includes several built-in presets optimized for different use cases. This guide provides detailed information about each preset.

Available Presets

Built-in presets in config/presets/:

Overview

Preset Directory Best For Text Direction
minimal config/presets/ Simple documents, quick conversions Horizontal
default config/presets/ General-purpose documents Horizontal
technical config/presets/ Technical documentation, API docs Horizontal
business config/presets/ Business reports, proposals, minutes Horizontal
vertical-novel config/vertical/ Japanese novels, vertical text Vertical

Standard Presets

minimal

Location: config/presets/minimal.yaml

Description: Bare minimum styling with black and white color scheme. Ideal for straightforward Markdown to Word conversion without visual embellishments.

Characteristics:

Style Details:

H1: 24pt, Bold, Black
H2: 20pt, Bold, Black
H3: 16pt, Bold, Black
Paragraph: 11pt, 1.5 line spacing
Code Block: 10pt, Light gray background (#f5f5f5)
Quote: 11pt, Italic, Left border (#999999)

Use Cases:

Example Usage:

docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
  input.md -o output.docx -p minimal --preset-dir /app/config/presets

default

Location: config/presets/default.yaml

Description: Balanced styling suitable for most documents. Professional appearance with subtle colors and borders.

Characteristics:

Style Details:

H1: 26pt, Bold, Navy (#2c3e50), Blue bottom border (#3498db)
H2: 22pt, Bold, Dark gray (#34495e), Gray bottom border (#95a5a6)
H3: 18pt, Bold, Dark gray (#34495e)
Paragraph: 11pt, 1.5 line spacing, Navy
Code Block: 10pt, Monospace, Light gray background (#ecf0f1)
Quote: 11pt, Italic, Gray (#7f8c8d), Blue left border (#3498db)

Use Cases:

Example Usage:

docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
  input.md -o output.docx -p default --preset-dir /app/config/presets

technical

Location: config/presets/technical.yaml

Description: Optimized for technical documentation with compact layout and code-friendly styling.

Characteristics:

Style Details:

H1: 24pt, Bold, Dark (#1a1a1a), Blue bottom border (#0066cc)
H2: 20pt, Bold, Dark gray (#333333), Gray bottom border (#4d4d4d)
H3: 16pt, Bold, Dark gray (#333333)
Paragraph: 10pt, 1.4 line spacing, Dark (#1a1a1a)
Code Block: 9pt, Monospace, Light gray background (#f5f5f5), Border
Quote: 10pt, Gray (#4d4d4d), Blue left border (#0066cc)

Use Cases:

Example Usage:

docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
  README.md -o README.docx -p technical --preset-dir /app/config/presets

business

Location: config/presets/business.yaml

Description: Professional styling for formal business documents with wide margins and a navy/blue color palette.

Characteristics:

Style Details:

H1: 24pt, Bold, Navy (#1a5490), No border
H2: 16pt, Bold, Dark Blue (#2e5c8a), Blue bottom border (#4a90e2)
H3: 13pt, Bold, Charcoal (#34495e)
Paragraph: 11pt, 1.75 line spacing, Dark (#2c3e50)
Code Block: 9pt, Consolas, Light gray background (#f5f5f5)
Quote: 11pt, Blue left border, Light blue background (#eef2f7)

Use Cases:

Example Usage:

docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
  report.md -o report.docx -p business --preset-dir /app/config/presets

Comparison Table

Visual Characteristics

Feature minimal default technical business
Font Family Serif Serif Sans-serif Serif
Base Size 10pt 11pt 10pt 11pt
Colors B&W Navy/Blue/Gray GitHub Blue/Dark Navy/Dark Blue
H1 Borders No Bottom Bottom No
H2 Borders No No No Bottom
Code Blocks Gray BG Dark BG GitHub Gray BG Gray BG
Quote Blocks Left Border Left Border Left Border Left Border + BG

Layout Characteristics

Feature minimal default technical business
Page Size A4 A4 A4 A4
Text Direction Horizontal Horizontal Horizontal Horizontal
Margins 2.54 cm 2.5 cm 2.5 cm 3.0 cm (wide)
Line Spacing 1.25× 1.5× 1.6× 1.75×

File Size (Approximate)

Preset Typical File Size*
minimal ~12 KB
default ~14 KB
technical ~13 KB
business ~14 KB

*For a 10-page document with standard Markdown content

Choosing a Preset

Decision Tree

Start Here
│
├─ Technical documentation or API docs?
│  └─ Yes → technical
│
├─ Formal business document?
│  └─ Yes → business
│
├─ General-purpose document?
│  └─ Yes → default
│
└─ Simple, minimal styling?
   └─ Yes → minimal

By Document Type

Document Type Recommended Preset
Technical Documentation technical
API Reference technical
Software Manual technical
Business Proposal business
Meeting Minutes business
Project Report business
General Document default
Academic Paper minimal
Quick Note minimal

Customizing Presets

All presets can be customized by copying and modifying the YAML files:

1. Copy a Preset

cp config/presets/default.yaml config/custom/my-style.yaml

2. Modify Settings

Edit the YAML file to adjust colors, fonts, spacing, etc. See the Configuration Guide for detailed information.

3. Use Your Custom Preset

docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
  input.md -o output.docx -c config/custom/my-style.yaml

Best Practices

Choosing Font Size

Choosing Line Spacing

Color Schemes

Professional:

Technical:

Creative:

Troubleshooting

Preset Not Found

Problem: Preset 'xxx' not found

Solution:

Example:

# Correct
docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
  input.md -o output.docx -p default --preset-dir /app/config/presets

# Also correct
docker run --rm -v $(pwd):/workspace forest6511/md2docx:latest \
  input.md -o output.docx -c /app/config/presets/default.yaml

Fonts Not Rendering

Problem: Fonts appear different in output document

Solution:

Vertical Text Issues

Problem: Vertical text not displaying correctly

Check:

Next Steps

Reference Files

All preset files are available in the repository:

View the complete source files for detailed styling specifications.

Last Updated: 2026-02-25