Skip to main content

convert-md

Right-click conversion between Markdown and Word, PDF, Excel, PowerPoint and HTML on Windows, built on Pandoc and Microsoft MarkItDown.

Tests License: MIT

What it does

Right-click on Menu Produces
.md, .markdown Convert to → Word .docx
Convert to → PDF .pdf (through Microsoft Word, or a Pandoc PDF engine)
Convert to → Excel .xlsx, one sheet per table
Convert to → PowerPoint .pptx, one slide per heading
Convert to → Web page self-contained .html
Convert to → All formats all of the above
Convert to → As set in the file the formats the file asks for (see below)
.docx .pdf .xlsx .xls .pptx .html .htm .csv .epub .msg Convert to Markdown .md

The Convert to submenu on a Markdown file

Convert to Markdown on a PowerPoint file

  • Output is saved next to the original. Nothing is overwritten: a repeat run writes Report (1).docx.
  • A small popup confirms what was created and lists any problems.
  • Optional Ctrl+Alt+M hotkey: select files in File Explorer and press it to get the same menu at the mouse pointer. Mixed selections work: Markdown files go out, everything else comes in.
Ctrl+Alt+M on a Markdown file Ctrl+Alt+M on any other file
Hotkey menu for a Markdown file Hotkey menu for another file

Install

Needs Windows 10 or 11 and Python 3.11 or newer from python.org (winget install --id Python.Python.3.12 -e --scope user).

  1. Download the latest release from the Releases page (Source code (zip)) and extract it, or git clone https://github.com/W3i-io/convert-md.

  2. In PowerShell, in that folder:

    powershell -ExecutionPolicy Bypass -File .\install.ps1
    

The installer sets everything up for your Windows account only (no administrator rights), offers to install AutoHotkey v2 for the hotkey, and runs a test conversion. Use -NoHotkey for the right-click menus only.

Prefer pip? Once it's published to PyPI:

py -m pip install convert-md
py -m convert_md setup

Updating, moving, uninstalling and troubleshooting: see DEPLOY.md.

On Windows 11 the menu entries are under Show more options, Shift + right-click, or Shift + F10.

Choosing formats inside the file

Convert to → As set in the file reads outputs: from the front-matter first, then the filename, and otherwise makes a Word document.

---
outputs: [docx, pdf, xlsx]
---

Or name the file Proposal.docx.pdf.md to get Proposal.docx and Proposal.pdf.

House styling

convert-md templates

creates starter reference.docx and reference.pptx in %LOCALAPPDATA%\ConvertMd\templates and opens the folder. Change their styles (fonts, heading colours, margins, slide masters) in Word or PowerPoint, not their text. From then on every conversion uses them, and Word-made PDFs follow the Word styles. Add a style.css in the same folder to style HTML output.

Command line

convert-md --to docx Report.md
convert-md --to docx,pdf,xlsx Report.md
convert-md --to all Report.md
convert-md --to md Contract.pdf Deck.pptx
convert-md doctor          # check the installation

If convert-md isn't found, use py -m convert_md instead: pip may have put the command in a folder that isn't on your PATH.

Known limitations

Area Limitation
Platform The menus and hotkey are Windows only. The command line also works on macOS and Linux.
Windows 11 menu Entries appear under Show more options, not in the compact top-level menu.
Excel output Only tables are exported. Text, lists and images outside tables are left out; there are no formulas.
PDF output Needs Microsoft Word, or a PDF engine such as Typst (winget install Typst.Typst). Engine-made PDFs look different from Word-made ones.
PowerPoint output One slide per heading with Pandoc's default layout; long sections overflow the slide. Use reference.pptx for your own master.
Scanned PDFs Image-only PDFs have no text to extract; run OCR on them first.
Conversion quality Complex layouts (multi-column PDFs, merged table cells, text boxes, charts) come through partially or as plain text.
Protected files Password-protected or rights-managed documents can't be converted.
Legacy formats Old .doc and .ppt files aren't supported; save them as .docx / .pptx first.
Several files at once Windows starts one conversion per file from the right-click menu, so each shows its own popup.
Hotkey Needs AutoHotkey v2. Works in File Explorer windows only: not on the desktop, in Open/Save dialogs or in other file managers.
Output folder Files are written next to the original, so read-only folders fail.
Remote images Images linked by URL in Markdown are downloaded by Pandoc when embedded.

Privacy and security

Conversions run entirely on your PC; convert-md sends nothing anywhere. It changes the registry only under your own account (HKEY_CURRENT_USER). See SECURITY.md for details and how to report a vulnerability.

Credits and licence

convert-md is MIT licensed. It relies on Pandoc (GPL, installed separately through pypandoc_binary), MarkItDown (MIT), openpyxl, Beautiful Soup, pywin32 and, for the hotkey, AutoHotkey (GPL).

Metadata

Release files for convert-md 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for convert-md 1.0.0
File Size Uploaded Provenance Actions
convert_md-1.0.0.tar.gz 32.6 kB With provenance Details for convert_md-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for convert-md 1.0.0
File Interpreter ABI Platform Actions
convert_md-1.0.0-py3-none-any.whl Python 3 none any Details for convert_md-1.0.0-py3-none-any.whl

Total release size: 51.9 kB

Release files / convert_md-1.0.0.tar.gz

Download URL convert_md-1.0.0.tar.gz
Size 32.6 kB
Tags Source
SHA-256 checksum
How to use checksums
9e19ab0e884e620580269b39ceadaa701e237084f3f938ef8f1412abf049650a
BLAKE2b-256 checksum
How to use checksums
c789a560038f3c1cd3174ba641cf4a0a63813f0ad6ae551ade20df77e6388c67
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / convert_md-1.0.0-py3-none-any.whl

Download URL convert_md-1.0.0-py3-none-any.whl
Size 19.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cfb81049250f240464fb27fb479489cd99b8a8a9743145de4281e03de6bbf4e0
BLAKE2b-256 checksum
How to use checksums
10fce5dff52fb0a40dafbf9b803d0e4bc11ab6c4dbd272cb7126d70531c3410c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Security for convert-md 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for convert_md-1.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page