A Windows GUI wrapper for Pandoc — convert Markdown files to DOCX with a system tray app, folder watching, context menu integration, and a built-in Markdown server.

• File Conversion — Convert .md files to DOCX or HTML via Pandoc
• System Tray — Runs minimized in the system tray for quick access
• Folder Watcher — Automatically converts new/modified .md files in watched directories
• Windows Context Menu — Right-click any .md file to convert directly from Explorer
• Markdown Server — Built-in HTTP server with live preview (Pandoc or marked.js rendering), syntax highlighting, mermaid diagrams, and dark/light theme toggle
• Conversion Settings — Per-format extra args, reference docs, and custom Lua filters
• Start with Windows — Optional auto-start on login

• Python 3.12+
• uv — Python package manager
• Pandoc — installed and accessible (or configure path in settings)

# Clone the repository
git clone https://github.com/<your-username>/pandoc-win.git
cd pandoc-win
# Install dependencies
uv sync
# Run the application
uv run python main.py

On first run, a settings.json will be created. See settings.json.example for the expected format.

uv run python main.py

The app starts in the system tray. Use the tray icon to:

• Open the main window
• Toggle folder watcher
• Open Markdown server in browser
• Access settings

uv run python main.py --convert "path/to/file.md" --format docx

Supported formats: docx, html

Enable in settings to serve a directory of .md files at http://localhost:8094 with:

• /pandoc/<file> — server-side Pandoc rendering
• /live/<file> — client-side marked.js rendering
• Auto-reload on file changes
• Syntax highlighting and mermaid diagram support

Build a standalone Windows executable using PyInstaller:

uv run python build_single.py

Or use the batch script:

build_all.bat

Output: dist/PandocWin/PandocWin.exe

pandoc-win/
├── src/
│ ├── controllers/ # Conversion orchestration
│ ├── models/ # Data models (settings, conversion request/result)
│ ├── services/ # Converter, folder watcher, MD server, file selector
│ ├── qt_components/ # Reusable PyQt6 widgets and theming
│ ├── ui/ # Main window and settings dialogs
│ └── utils/ # Context menu, system tray, icon, colors
├── filters/ # Pandoc Lua filters
├── static/ # CSS/JS assets for MD server
├── templates/ # Reference documents for conversion
├── main.py # Entry point
├── pyproject.toml # Project config and dependencies
└── settings.json.example

Copy settings.json.example to settings.json and adjust:

MIT

Note: This project is a GUI wrapper that calls Pandoc as an external tool. Pandoc must be installed separately.