Rich Text to Markdown Converter

What Is Rich Text to Markdown

Rich text refers to formatted text that carries visual styling information alongside the raw characters — bold, italic, headings, hyperlinks, tables, and other formatting attributes. When you copy formatted content from an application like Microsoft Word, Google Docs, a web browser, or an email client, your operating system's clipboard holds both a plain text representation and an HTML representation of the copied content simultaneously.

Rich text to Markdown conversion works by reading the HTML representation from the clipboard and translating its HTML tags into equivalent Markdown syntax. This is fundamentally different from pasting plain text, which discards all formatting. The result is Markdown that faithfully represents the visual structure of your original content — headings become # markers, bold text becomes **bold**, and tables become GFM pipe tables.

SmartMarkdown's rich text converter uses a clean HTML-to-Markdown transformation layer that handles the full range of HTML formatting tags produced by modern word processors, email clients, and web applications — producing output that requires minimal cleanup before use.

How Clipboard Conversion Works

The clipboard on every major operating system supports multiple data types simultaneously. When you copy formatted text from a rich text application, the clipboard typically contains:

• text/plain: The raw text without any formatting.
• text/html: An HTML representation of the formatted content, including all styling tags.
• application/rtf: An RTF representation in some applications.

SmartMarkdown reads the text/html data from the clipboard paste event using the browser's Clipboard API. It then passes the HTML string through a purpose-built HTML-to-Markdown converter that maps each HTML element to its Markdown equivalent:<h1>–<h6> become heading markers, <strong> and <b> become **bold**, <em> and <i> become *italic*, and so on.

This approach works for any application that writes HTML to the clipboard when copying rich text — which includes virtually all modern word processors, productivity suites, email clients, and web browsers on every major platform.

Supported Source Applications

The rich text converter works with content copied from any application that writes HTML to the clipboard:

• Microsoft Word: All Word heading styles, bold, italic, underline (converted to emphasis), hyperlinks, numbered and bulleted lists, and tables are preserved through the clipboard.
• Google Docs: Google Docs heading levels, inline formatting, links, lists, and tables all carry cleanly through the clipboard. Google Docs is one of the cleanest sources for clipboard HTML conversion.
• Notion: Notion pages carry their block structure through the clipboard as HTML. Headings, paragraphs, bulleted and numbered lists, code blocks, and tables all convert. Toggle and callout blocks are converted to their nearest Markdown equivalent.
• Email clients: Gmail, Outlook (web and desktop), Apple Mail, and most other email clients write HTML to the clipboard when copying formatted email content. This makes it easy to convert email threads, newsletter templates, or formatted email responses to Markdown.
• Web browsers: Content copied from any web page carries the page's HTML structure through the clipboard. Articles, documentation pages, and blog posts copied from the browser convert to Markdown with their original heading structure, links, and formatting intact.
• Confluence: Confluence pages copied from the browser or Confluence editor carry their HTML to the clipboard. Confluence's macro-rendered content (code blocks, info panels, tables) converts to standard Markdown.

Benefits

Rich text to Markdown conversion provides the fastest possible path from formatted content in any application to portable, version-controllable Markdown:

• No export or download required: You do not need to export a file, download it, upload it, or install any browser extension. The entire workflow is copy → paste → convert → copy Markdown.
• Works with any source: Because the converter reads standard clipboard HTML, it works with content from any application on any platform. You do not need a dedicated export integration for each source application.
• Preserves structure: Unlike plain-text pasting, which loses all formatting, rich text conversion preserves the complete visual structure of your content — headings, bold, italic, lists, links, and tables.
• Reduces cleanup time: Converting via the rich text clipboard route produces cleaner Markdown than most export methods, which often introduce application-specific CSS classes, inline styles, or metadata that must be stripped manually.

Common Use Cases

Rich text to Markdown conversion is used in a wide range of content workflows:

• Quick web content capture: Developers and researchers copy documentation, articles, or reference material from any website and convert it to Markdown for storage in a personal knowledge base like Obsidian or a project wiki.
• Email thread to documentation: Technical decisions, design discussions, and project updates communicated over email are converted to Markdown and committed to a repository as architecture decision records or project logs.
• Copy from any app to Markdown: Technical writers working in Word or Google Docs convert their drafts to Markdown for import into documentation platforms like Docusaurus or MkDocs without going through a file export workflow.
• Blog content preparation: Content creators draft articles in Google Docs or Notion and convert them to Markdown for publishing with MDX-based static site generators like Astro, Next.js, or Gatsby.

Tips for Best Results

Follow these practices to get the cleanest Markdown output from your rich text paste:

• Use standard paste (Cmd+V or Ctrl+V). The "paste as plain text" shortcut (Cmd+Shift+V on Mac, Ctrl+Shift+V on Windows and Linux) discards the HTML clipboard data and pastes only the raw text, stripping all formatting. Always use the standard paste shortcut to preserve rich text.
• Ensure your source has proper heading structure. Content without semantic heading tags (H1, H2, H3) will convert as plain paragraphs, even if the source uses larger bold text to visually simulate headings. Use proper heading styles in your source application for accurate conversion.
• Some apps strip formatting from clipboard. Certain applications — particularly security-conscious enterprise tools — do not write HTML to the clipboard even when copying formatted content. If your paste produces unformatted text, try copying from a different source or use a file export method instead.
• Review and clean up after conversion.Even clean clipboard HTML can contain inline styles, font tags, or application-specific wrapper elements that produce minor artifacts in the Markdown output. Review the converted Markdown in the editor and use Search & Replace to clean up any repeated patterns.