Skip to content

Chrome, Edge, Firefox, and Raycast extension for converting rich text from clipboard to Markdown, with special handling for Microsoft Word content

License

Notifications You must be signed in to change notification settings

ewilderj/mdconv

Repository files navigation

Markdown Clipboard Converter

A multi-platform clipboard converter for bidirectional conversion between rich text and Markdown, Org-mode, and Slack formats. Available as a Chrome/Edge/Firefox browser extension and a Raycast extension for macOS.

Primary Platform: Browser Extension – Paste formatted content from Microsoft Word, Google Docs, or the web, preview the converted Markdown instantly, and copy it back to your clipboard in a single click.

Install

Raycast extension

The Raycast extension provides six commands for bidirectional clipboard conversion on macOS. Install from the Raycast Store.

Features

  • One-click conversion – Read HTML from the clipboard and convert it to Markdown using Turndown.
  • Context menu integration – Right-click on selected text anywhere on the web and choose "Copy as Markdown" to convert and copy formatted content instantly.
  • Smart fallback – Gracefully handles plain text when no rich content is available.
  • Automatic copy-back – Immediately writes the generated Markdown to your clipboard after each conversion.
  • Live paste listener – Supports keyboard pastes (Cmd/Ctrl + V) directly inside the popup.
  • Word-aware headings – Promotes Microsoft Word clipboard headings so Markdown keeps its structure.
  • Google Docs normalization – Cleans up Docs-specific spans and non-breaking spaces so the output stays readable.
  • Monospace heuristics – Detects Courier-style Word paragraphs and emits fenced code blocks.
  • Bold span detection – Upgrades inline font-weight: bold spans into Markdown **strong** text.
  • Image support – Includes conversion of inline images (beware large images will result in massive Markdown!)

Screenshot

Screenshot of Markdown Clipboard Converter

Usage

Method 1: Extension Popup

  1. Click the extension icon to open the popup.
  2. Press Paste & Convert or press Cmd/Ctrl + V with formatted content on your clipboard.
  3. The Markdown appears in the output area and is automatically copied back to your clipboard so you can paste it wherever it's needed.

Method 2: Context Menu (New!)

  1. Select any formatted text on a webpage, document, or local HTML file.
  2. Right-click on the selection and choose "Copy as Markdown" from the context menu.
  3. The converted Markdown is automatically copied to your clipboard – no popup needed!
  4. A green checkmark (✓) badge appears on the extension icon to confirm successful conversion.

Clipboard permissions: Chrome will prompt for clipboard permissions when first reading or writing. Accept the prompt so the extension can function correctly.

Raycast Extension

Six native Raycast commands for clipboard conversion on macOS:

Command Direction
Convert Clipboard to Markdown Rich text → Markdown
Convert Clipboard to Org Rich text → Org-mode
Convert Clipboard to HTML Markdown/Org → HTML
Convert Clipboard to Google Docs Markdown/Org → Google Docs
Convert Clipboard to Word 365 Markdown/Org → Word
Convert Clipboard to Slack Markdown/Org → Slack mrkdwn
  1. Copy content from any application
  2. Run the appropriate command in Raycast
  3. Converted output is automatically copied back to your clipboard

For org users

If you use org-mode, mdconv has built-in Org output support:

  • Browser extension: Select "Org" from the format dropdown, or use the "Copy as Org" context menu
  • Keyboard shortcut: Cmd+Shift+O (Mac) / Ctrl+Shift+O (Windows/Linux)
  • Raycast: Use the "Convert Clipboard to Org" command

For Developers

See DEVELOPERS.md for:

  • Architecture overview and platform design
  • Build instructions for Chrome, Firefox, and Raycast
  • Development workflow and testing
  • Code quality standards

Credits

  • @nahals for original inspiration, Windows usage, and more
  • This extension builds on the amazing Turndown library

License

About

Chrome, Edge, Firefox, and Raycast extension for converting rich text from clipboard to Markdown, with special handling for Microsoft Word content

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors