Info about the places where Markdown Here works, including limitations and workarounds.
If you find a new problem (or improvement!), or if you find a site that (almost) works, or if you have workflow suggestions, please edit this wiki page, or create a Github issue, or post to the MDH Google Group.
First-class client. Works great. See open issues here.
First-class client. Works great. See open issues here.
Comparable to Gmail. Except the MDH button doesn’t enable while focus is in the “quick compose” box (issue #221) – but it the hotkey and context menu still work there.
Markdown Here works with Google Groups posts. You can use it in the GG rich compose box, or when you’re posting via email. One caveat: Digest emails strip all styling.
A user discovered that Markdown Here works in the Evernote web interface. It works because Evernote uses a somewhat backlevel version of TinyMCE.
Works moderately well.
There was a styling fix for Blogger in v2.9.0, so make sure you reset your Primary Styling CSS.
There is currently a problem with editing a draft that was saved rendered: it’s no longer possible to unrender, and the styling looks wrong (in the edit view). It was discovered that Blogger is mangling some attributes – like style and title (which is used for storing the original MD). I created a separate extension to work around the problem: https://github.com/adam-p/wysiwyblogger
Other caveats:
Thanks to lambdaalice for originally reporting that MDH worked with Blogger and for detailing the previous bad behaviour.
Google Sites seems to use an editor similar to Gmail and Google Groups.
You can see some test pages here.
Works very well.
Caveats:
<p> and <div> tags, and Yahoo uses the latter for paragraphs.)Works very well.
Caveats:
As of version 2.9.0, earlier problems are fixed and Wordpress is working well. Part of the fix came from changes to the default styling. If you’ve never customized your CSS, you should click the “Reset to Default” button for the “Primary Styling CSS”. If you have customized your CSS, you can take a look at the default CSS and decide what to take.
Caveats and tips:
iframe restrictions. Click the “Pop-out” link and MDH will become usable in the separate window. Alternatively, use the full editor in the admin interface. (See issue #124.)Enter once – it looks like a blank line, but it isn’t, and it’s still only a single Enter for Markdown purposes. Some users find this disorienting, and there’s some discussion here about a possible different approach to composing and styling.Thanks to Sina Iravanian for originally discovering that MDH works with Wordpress.
Check out a test post.
@rfay reports that Markdown Here works great with the Freshdesk ticket editor.
@alexandru and @leviwheatcroft reported (via issues) that Markdown Here works with the Fastmail webmail service.
Caveats:
-- (dash-dash) instead of -- (dash-dash-space). You can modify your signature in Fastmail’s Settings/Accounts.ProtonMail is an end-to-end encrypted email service.
Antonio Gil reported that Markdown Here works very well with it.
Postbox is a non-free desktop email client based on Thunderbird, and user markgoodson requested that Markdown Here support it. The Mozilla extension now works with it, but with some major caveats:
about:config in Firefox, “Config Editor” in Thunderbird). Note: Make them all string values.
Facebook “Notes” feature users TinyMCE as its editor, so MDH kinda works. But there are caveats.
Ctrl+I works, though. It seems that Notes doesn’t allow <em> but does allow <i>.The Google Hangouts web interface supports limited rich editing – bold, italics, and underline. Markdown Here can format bold and italics in the interface, with caveats:
<p> element makes the little compose box look oddly expanded after rendering. There’s no ill effect, though.mail.google.com page and the talkgadget.google.com iframe where the chat box is. (See issue #124.)
Tumblr is a blogging-ish site and service.
It looks likes Tumblr strips out inline styles, so none of the styling in MDH will be applied. The formatting types supported by the Tumblr rich formatting toolbar seem to work fine: bold, italics, links, ordered and unordered lists, blockquotes, images. Code blocks will be left intact, but with no syntax highlighting (and inline code is completely stripped). If you work within those constraints, it’s usable. Example post here. And it’s no worse than Tumblr’s optional built-in Markdown renderer, as can be seen here.
Tumblr also has the option to use a plaintext editor that allows the input of raw HTML. If MDH’s output is pasted into that, it actually looks pretty good. There is an outstanding feature request (#43) for the ability to render to raw HTML text that would enable this workflow.
Squarespace is a non-free site creation and hosting service.
MDH ought to work, but looks pretty bad. Needs to be investigated.
Blackboard Learn (official site) is a “virtual learning environment and course management system”.
MDH works well in at least some areas of the site. Details can be found in issue #293.
There’s a whole class of rich editors for use in web pages that Markdown Here woks with.
TinyMCE is an open source “web based Javascript HTML WYSIWYG editor control”. It’s used as a rich edit control by these sites (at this time), among others: Evernote, Wordpress, Facebook (Notes). It seems to have lots of customization options for changing the way it works and what formatting it allows and doesn’t. Individual sites of reasonable importance with idiosyncratic behaviour should still have a separate section on this page.
TinyMCE inserts <p> elements on every Enter keypress. Prior to Markdown Here version 2.9.0, this would cause extra blank lines in code blocks, break tables, and probably other bad things. MDH’s <p>-vs-<br> detection basically fixes this. (Although it will looks odd when writing, since there’s more space between newlines than one expects when writing Markdown.)
An annoying TinyMCE oddity is that pasting plain-text is not the same as typing. When pasting multi-line text, line breaks (<br>) are inserted; when typing, paragraphs (<p>) are created.
This can cause Markdown Here to be confused about what rendering method to use. So, generally speaking, it’s best to not mix and match multi-line pasted and typed Markdown. And if you do paste some stuff, try to render it separately using a selection.
CKEditor seems to be exactly the same (for our purposes) as TinyMCE – both in what it is and how it behaves. So read that section.
Aloha Editor is also an open source rich web editor. Like TinyMCE it inserts <p> elements, but unlike TinyMCE it doesn’t switch to <br> when pasting. Markdown Here seems to render it quite well.
Redactor is a rich editor, like TinyMCE (but not open source). Like TinyMCE it inserts <p> elements, but unlike TinyMCE it doesn’t switch to <br> when pasting. Markdown Here seems to work pretty well with it, with caveats:
!important. See the default Primary Styling CSS for an example used with Wordpress.Hallo is a simple rich editor. Markdown Here seems to work reasonably well with it.
wysihtml5 is also an open-source rich editor. It inserts <br> on each Enter. Markdown Here seems to work pretty well with it.
bootstrap-wysihtml5 is based on wysihtml5 for use with the Twitter Bootstrap web toolkit. Markdown Here works well with it as well.