Markdown Here: Write Email in Markdown, Render Before You Send
GitHub describes it as Google Chrome, Firefox, and Thunderbird extension that lets you write email in Markdown and render it before sending.. The repository metadata lists JavaScript as its primary language. The metadata lists the MIT license. This article stays within the project description and details documented in the GitHub repository README.
At a glance
- What is it?
- Markdown Here is a browser and Thunderbird extension that converts Markdown in your email compose box into formatted HTML, with syntax highlighting and TeX support. It solves the awkward workflow of writing email in a separate Markdown editor and copying the preview over.
- Who is it for?
- Adopt Markdown Here if you regularly write technical emails with code blocks, need TeX formulas, or want to avoid copying from a separate Markdown preview. Skip it if you never use rich formatting, if your email client lacks a rich editor..
- Can I use it commercially?
- Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
- Is it still maintained?
- Probably not. The repository last received commits 15 months ago, on August 22, 2025.
- What is it written in?
- Mainly JavaScript, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.
Star history
- adam-p/markdown-here60,244 ★ · -4
| Repository | 2026-08-13 | 2026-11-15 |
|---|---|---|
| adam-p/markdown-here | 60.2k | 60.2k |
-4 Stars in the last 94 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
The Problem It Solves
Writing email with code in it is tedious. Markdown Here's README describes the author's original workflow: write Markdown in the GitHub in-browser editor, copy the preview, and paste it into email. That is absurd, and this extension exists to remove that step. It targets people who compose email in Gmail, Hotmail, Yahoo, Thunderbird, Google Groups, Blogger, Evernote, and WordPress, and who want to write in Markdown directly in the compose box. The core use case is technical communication: code snippets, fenced blocks with syntax highlighting, and TeX mathematical formulae. The extension does not replace your email client; it adds a rendering layer that converts Markdown to HTML and back again.
How the Toggle Mechanism Works
The central action is a toggle. You write Markdown in the rich editor, then trigger "Markdown Toggle" via a right-click context menu item, a toolbar button, or a hotkey (SHIFT+ALT+M by default). The extension converts the Markdown into rich HTML, and you send the email as formatted text. The reverse is also possible: right-click anywhere in the rendered HTML and choose "Markdown Toggle" to revert to the original Markdown. The documentation warns that any changes you make to the pretty HTML are lost when you revert. In Gmail, you can use the browser's Undo command instead, but you might lose the last few characters you typed. The toggle is context-sensitive: if you select a portion of the email, only that selection is converted, which is useful when your email is not entirely Markdown. This selection-based conversion is the key to handling replies where the original message is not wrapped in a blockquote.
Installation and First Steps
Installation differs by browser. For Chrome, go to the Chrome Web Store page and install normally, then reload your webmail or restart Chrome. For Firefox and Thunderbird, install from the Mozilla Add-ons site or search for "Markdown Here" in the Add-ons manager, then restart the application. Opera users need version 16 or higher, which is Chromium-based. For manual development, clone the repo and load the `src` directory as an unpacked extension in Chrome's Developer Mode. For Firefox, follow MDN's "Your first WebExtension" instructions. After installation, the critical step is to reload your webmail page before using it, otherwise Markdown Here may not work. You also need to ensure you are using the rich editor: in Gmail, click "Rich formatting" if it is visible; in Thunderbird, enable "Compose messages in HTML format" in Account Settings. Then compose a Markdown email, right-click, and choose "Markdown Toggle".
Compatibility and Reply Handling
The README lists supported services: Gmail, Hotmail, Yahoo, Google Groups, Blogger, Evernote, WordPress, and Thunderbird. The extension is careful about replies. In Gmail, Thunderbird, and Google Groups, you can use the toggle normally, and the original email you are replying to is left alone. Technically, the documentation states that existing `blockquote` blocks are left intact. In Hotmail and Yahoo, which do not wrap the original in a blockquote, you must select the part of the reply you wrote and convert only that selection. The same selection method works in Gmail and Thunderbird if you prefer. This distinction matters: if you convert the entire compose box in Hotmail, you might accidentally render the quoted original as Markdown, producing a mess. The selection feature is the workaround, but it requires manual action every time. This is a genuine usability trade-off for those clients.
Limitations and Failure Modes
The biggest limitation is that Markdown Here only works in rich editors. If your email client is in plain-text mode, the toggle will not work. The README explicitly instructs you to enable rich formatting. Another limitation is the revert behavior: any formatting changes you make to the rendered HTML are lost when you toggle back to Markdown. That means you cannot edit the HTML and then expect to recover the Markdown. A more practical failure mode is the Mozilla review delay. The README notes that it can take up to a month for Mozilla to approve changes, so Firefox and Thunderbird updates lag behind the GitHub releases. You can manually install the newest version from the add-on versions list, but that requires trusting an unreviewed build. For Chrome, the Web Store is the usual install route (the README also describes a manual Developer Mode install), and you must reload webmail after installation.
Alternatives and Their Different Approaches
The obvious alternative is to write in a standalone Markdown editor and copy the rendered HTML into email. That is the workflow Markdown Here replaces, and it still works if you prefer a full preview pane. Another alternative is to use email clients that natively support Markdown, such as some desktop clients that render Markdown in the compose window. Those clients integrate Markdown as a first-class feature, not as an extension.. The difference is that Markdown Here operates inside existing webmail and Thunderbird, so you do not change your email provider. A third alternative is to use a browser extension that converts the entire page, but that would not target the compose box specifically.
Maintenance, Licensing, and Upgrade Cost
The repository is under the MIT license, which permits commercial use, modification, and redistribution with attribution. The project is not archived, and the last push was on 2025-08-22, and the latest release, version 2.16.0, was published on 2025-07-10. The latest releases, 2.15.0, 2.15.1 and 2.16.0, appeared between June 24 and July 10, 2025, and the last push was on 2025-08-22, so there has been no recent activity. The upgrade cost is low for Chrome users because the Web Store handles updates automatically. For Firefox and Thunderbird, the Mozilla review delay means you might wait a month for a fix to appear in the store, and you may need to manually install from the versions list to get the latest changes. That is a real cost for users who need urgent bug fixes. The repository includes a CHANGES.md file as well as GitHub releases to see what changed. You should verify that your email client still works after an update, especially after a browser update.
Editorial conclusion
Adopt Markdown Here if you regularly write technical emails with code blocks, need TeX formulas, or want to avoid copying from a separate Markdown preview. Skip it if you never use rich formatting, if your email client lacks a rich editor.. Before adopting, verify that your email client's rich editor is supported and that the extension's latest version is available for your browser; for Firefox and Thunderbird, Mozilla review delays mean you may need to install from the versions list to get recent fixes. The latest release is v2.16.0 from July 2025 and the last push was on 2025-08-22, so check the GitHub releases page for the current version and the wiki pages for what can be done with it.
Frequently asked questions
How do I use Markdown in an email with Markdown Here?
Install the extension, open a new message, make sure the rich editor is on, compose in Markdown, then right-click the compose box and choose Markdown Toggle, click the toolbar button, or press SHIFT+ALT+M by default. What you see is the same text rendered into rich HTML.
How do I install Markdown Here on Firefox and Thunderbird?
From the Mozilla Add-ons site, or through Tools then Add-ons and a search for Markdown Here, then restart Firefox or Thunderbird. The README notes that Mozilla can take up to a month to approve a change, so updates lag the repository, and you can install the newest unreviewed version from the list of versions.
What happens to my HTML edits if I toggle Markdown Here back to Markdown?
They are lost. In Gmail you can use the browser Undo command instead, CTRL+Z or CMD+Z, but the README warns that you might also lose the last few characters you entered.
Can Markdown Here convert only part of a reply?
Yes. Select the text, right-click it and choose Markdown Toggle, and only the selection is rendered. This is the route to use in Hotmail and Yahoo, which do not put the original message in a blockquote and would otherwise have their quoted history converted too.
What licence is Markdown Here released under?
MIT, with a LICENSE file at the repository root alongside CLA-entity.md and CLA-individual.md for contributor licensing and a PRIVACY.md. The newest tagged release is v2.16.0 from 2025-07-10 and the last push was on 2025-08-22.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/adam-p-markdown-here)Star history chart for your README
[](https://hysenlabs.com/projects/adam-p-markdown-here)Was this useful?