# Mxe

> Converts Markdown files to PDF, DOCX, or HTML with table of contents, custom fonts, Mermaid diagrams, and web article downloading.

- Skill: `kbarbel640-del/mxe` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add kbarbel640-del/mxe`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/mxe/raw
- Safety review: CAUTION (external: skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing, Office Documents, PDF Documents
- Tags: Cli, Document Conversion, Docx, Html, Markdown, Mermaid, Pdf
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/kbarbel640-del/mxe

---

# MXE Skill - Markdown Export Tool

Convert Markdown files to PDF, DOCX, or HTML with advanced features.

## When to Use

Use MXE when the user wants to:
- Convert Markdown to PDF with nice formatting
- Export documents with Mermaid diagrams
- Generate PDFs with table of contents
- Create professional documents from Markdown
- Download web articles as Markdown

## Installation Check

```bash
which mxe || echo "Not installed"
```

If not installed:
```bash
cd /Users/tuan/.openclaw/workspace/mxe && npm run build && npm link
```

## Basic Usage

```bash
# Simple PDF conversion
mxe document.md

# With table of contents
mxe document.md --toc

# Specify output directory
mxe document.md -o ./output
```

## Font Options

```bash
# Custom body font
mxe document.md --font roboto

# Custom code font  
mxe document.md --mono-font fira-code

# Both
mxe document.md --font inter --mono-font jetbrains-mono
```

**Available body fonts:** `inter` (default), `roboto`, `lato`, `opensans`, `source-sans`, `merriweather`

**Available mono fonts:** `jetbrains-mono` (default), `fira-code`, `source-code`

## Mermaid Diagrams

```bash
# Default theme
mxe document.md

# Forest theme
mxe document.md --mermaid-theme forest

# Hand-drawn style
mxe document.md --hand-draw

# Dark theme with ELK layout
mxe document.md --mermaid-theme dark --mermaid-layout elk
```

**Themes:** `default`, `forest`, `dark`, `neutral`, `base`

## Full Example

```bash
# Professional PDF with all features
mxe report.md \
  --toc \
  --font roboto \
  --mono-font fira-code \
  --mermaid-theme forest \
  -o ./output
```

## Output Formats

```bash
mxe doc.md -f pdf      # PDF (default)
mxe doc.md -f docx     # Word document
mxe doc.md -f html     # HTML file
mxe doc.md -f clipboard # Copy to clipboard
```

## Download Web Articles

```bash
# Download and convert URL to PDF
mxe https://example.com/article

# Download as Markdown only
mxe https://example.com/article -f clipboard
```

## Tips

1. **Mermaid requires mmdc**: Install with `npm i -g @mermaid-js/mermaid-cli`
2. **Images are embedded**: Local images are base64 encoded into the PDF
3. **Custom CSS**: Use `-s style.css` for custom styling
4. **Bookmarks**: PDF bookmarks are auto-generated from headings (disable with `--no-bookmarks`)

## Location

Tool source: `/Users/tuan/.openclaw/workspace/mxe`