Basic Usage
  1. Reload your email web page or restart your web browser.
  2. Start a new email message.
  3. Type some Markdown into the email.
    Try this: _Hello_ `Markdown` **Here**!
  4. Right-click in the email and then click "Markdown Toggle". (Or click the button on the toolbar. Or press CTRL+ALT+M)
  5. The message should now look pretty cool. Send it to your friends!
Resources and Links

Primary Styling CSS
Syntax Highlighting CSS
Theme:
Preview
Notes
  • Changes are automatically saved and synchronized (if sync is enabled in your browser).
  • The syntax highlighting styles are applied after the primary styling, and so take precedence.
  • Some email editors and browsers impose their own styles. Those may not be apparent here.
TeX Mathematical Formulae Support

Privacy Issues:

  • To generate the image for the formula, a request is sent to Google. That effectively means that you are sharing your formula with Google. It also means that recipients of your message will be making a request to Google to have the image rendered.
  • If you customize the formula rendering tag, you should use a secure (https://) path. Not all rendering services provide a secure option.

Customization and Use:

  • If this feature is enabled, text between dollar signs — $ — will be interpreted as mathematical formulae. For example, $\Delta$ would be rendered as a delta symbol.
  • For render customization options, see the Google Charts documentation for this service.
  • A good resource for creating TeX formulae is the CodeCogs Equation Editor.
  • Formulae are rendered to images, so email recipients will have to enable images to be shown to see the rendering.
  • If you customize the rendering tag, you can (and should) use either or both of {mathcode} and {urlmathcode} as placeholders.
    • {mathcode}: The text between the $ symbols — i.e., the raw TeX formula; like \Delta.
    • {urlmathcode}: The URL-encoded form of the TeX formula; like %5CDelta.
  • If you customize the <img> tag, you should include an alt attribute that has as human-readable a value as possible, like {mathcode}. This value of this attribute will be used for the plaintext version of the email (when sent from Gmail and Thunderbird), and used by screen readers for sight-impaired recipients.

Hotkey (aka keyboard shortcut)
 +   +   + 
  • Chrome: You must reload your email web page for the new hotkey setting to take effect.
  • Firefox and Thunderbird: You must restart the application for the new hotkey setting to take effect.
  • You must use an alphanumeric key for the shortcut (varies by language and keyboard).
  • The Windows key and the OS X ⌘ key cannot be used in the shortcut.
  • To disable the use of this hotkey, leave the "key" text box empty.
Advanced and Miscellaneous

Currently only supported in the Gmail web interface and Thunderbird (and Postbox and Icedove).

When you send an email, this checks the content to see if it looks like you wrote it in Markdown, but forgot to render it (i.e., click "Markdown Toggle") before sending. This may need to be disabled if it interferes with your ability to send email.

If this feature stops working for you, please let us know by posting to the "markdown-here" Google Group or creating an issue in the Github project. (Hooking into the email sending web UI is brittle and will sometimes break.)


This is great if you want to put a table of contents or other internal links into your content. Learn about how to use it in the MDH wiki.

It's disabled by default because it creates visual noise in Thunderbird. (And most people probably won't use the feature.)



Contributing

If you have ever put a code block into an email, then you can help make Markdown Here better. CONTRIBUTING.md

Help make Markdown Here available in your language. Translations are welcome.

Changes saved