Skip to content

Compatibility

Jump to bottom
Adrien Centonze edited this page Jan 7, 2017 · 7 revisions

Quelques infos a propos des site sur lesquels Markdown Here fonctionne, en incluant les limitations liées au langages et les solutions pour y remédier.

Si vous identifiez des nouveaux problèmes ( ou des améliorations ) ou si vous trouvez un site qui fonctionne (presque) ou si vous avez une suggestion sur la méthode de travail, s'il vous plais, editez cette page wiki ou creer une issue ou envoyez une requette à MDH Google Group.

### Les plateforme sur lesquels cela fonctionne bien #### Gmail

Client de premier ordre. Fonctionne trés bien. Allez voir les issue en court here.

#### Thunderbird

Client de premier ordre. Fonctionne trés bien. Allez voir les issue en court here.

#### Inbox By Google

Comparable à Gmail. Exepté pour le bouton MDH qui ne permet pas de se centrer rapidement sur le "quick compose" box (issue #221) -- mais les raccourcis et les menus contextuels fonctionne la dessus.

#### Google Groups

Markdown Here fonctionne avec les posts google groups. Vous pouvez l'utiliser dans la GG rich compose box ou lorsque vous evoyez un post via email. Une mise en garde cependant : les processeurs d'email enlèvent toute les mises en forme.

#### Evernote

Un utilisateur à découvert que Markdown Here fonctionne dans l'interfece Web d'Evernote. Cela fonctionne car Evernote utilise une base de TinyMCE.

#### Blogger

Fonctionne moyennement bien.

Il y a eu un fix pour Blogger dans la version v2.9.0 donc soyez sur que vous ayez réinitialisé votre feuille de CSS principale.

Il existe cependant un problème avec l’édition de brouillons qui ont été sauvegardé en forme: Il n'est plus possible de changer la mise en forme et le style à soudainement l'air mauvais (en vue édition). Il à été trouvé que Blogger massacre certains attributs -- comme le style et les titres (utilisé pour editer le MD original). J'ai créé une extension séparé pour traiter les problèmes : https://github.com/adam-p/wysiwyblogger.

Les autres mises en garde :

  • La syntaxe de mise en valeur sur fond noir semble ne pas s'afficher correctement. Vous pouvez voir un exemple au bas de ce post.

Merci à @lambdaalice pour avoir initialement rapporté le fait que MDH fonctionne avec Blogger et avoir détaille les mauvais usages.

#### Google Sites

Google Sites semble utiliser un éditeur similaire à Gmail et aux Google Group.

Vous pouvez voir quelques pages d'exemple ici.

#### Outlook.com/Hotmail

Fonctionne très bien!

Mise en garde :

  • Les email reçus depuis Yahoo n'affichent pas correctement les séparations de paragraphes. (Hotmail enleve les balises <p> et les <div> et Yahoo utilise le latter pour les paragraphes)
  • Pas d'exclusion de réponse
  • Pas de détection d'oublis-de-mise-en-forme
#### Yahoo email

Fonctionne trés bien.

Mise en gardes :

  • Certaines réponses excluent les problèmes.
  • Pas de détection d'oublis-de-mise-en-forme.
#### Wordpress

Sur la version 2.9.0 certains problèmes ont été réglé et Wordpress fonctionne bien. Une partie du fix viens du chagement du style de mise en forme. Si vous avez customisé votre CSS, vous pouvez cliquer sur le bouton "Reset to default" pour reprendre le "Primary Styling CSS". Si vous avez customisé votre CSS vous pouvez regarder le CSS par defaut pour savoir quoi faire.

Mise en garde et astuces :

  • Le bouton "Preview" de wordpress est votre amis! Ce que vous pouvez voir ici (mais pas tellement dans la editing box) est le rendus final que vous aurez.
  • Après avoir cliqué sur rendus, le code en ligne apparaît en typo non-monospace mais en monospace correcte en mode "preview" et dans le rendus final.
  • La section en dessous sur coller VS tapper s'applique ici.
  • Comme avec le rich controls de Yahoo si les boutons de mise en forme de paragraphe sont cliqué, le ciblage d’éléments ne fonctionne plus et l'affichage Markdown non plus. issue #16.
  • Dans Chrome, MDH ne fonctionne pas dans les listes déroulantes d’édition de post, ceci est dus aux restriction liées aux sources src des balises iframe. Cliquez sur le liens "Pop-out" et MDH deviendra utilisable dans une fenêtre séparé. De manière alternative, utilisez l’éditeur de l'interface Admin issue #124.)
  • Cela peut être déstabilisant lorsque vous rééditez de nouveaux (paragraphes) espaces en appuyant sur Enter une fois -- cela ressemble à une ligne blanche mais ça ne l'est pas, c'est un simple Enter pour le langage MDH. Certains utilisateurs trouve cela destabilisant et dans cette discution à propos des differentes approches de composition et de style.

Merci à Sina Iravanian pour avoir fait la découverte que le MDH fonctionne avec Wordpress.

Allez voir ce test post.

#### Freshdesk

@rfay reports que le langage Markdown Here / MDH fonctionne très bien avec le Freshdesk ticket éditeur.

#### Fastmail

@alexandru and @leviwheatcroft reported (via issues) that Markdown Here works with the Fastmail webmail service. @alexandru and @leviwheatcroft reported (via issues) that Markdown Here works with the Fastmail webmail service.

Caveats:

  • Fastmail defaults to plaintext editing. Switch to rich edit. (You can make the switch permanent in the settings.)
  • Fastmail's default rich signature has a broken signature separator -- it uses -- (dash-dash) instead of -- (dash-dash-space). You can modify your signature in Fastmail's Settings/Accounts.
#### ProtonMail

ProtonMail is an end-to-end encrypted email service.

Antonio Gil reported that Markdown Here works very well with it.

### Postbox

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:

  • There's no options page. However, you can open the "Config Editor" from the Preferences dialog and copy/paste options from Firefox's or Thunderbird's equivalent config editor (about:config in Firefox, "Config Editor" in Thunderbird). Note: Make them all string values.
    • I just couldn't figure out how to open a tab with the options page. This will probably require the assistance of Postbox or someone familiar with developing for it.
### Facebook

Facebook "Notes" feature users TinyMCE as its editor, so MDH kinda works. But there are caveats.

  • The Preview function doesn't play well with Markdown Here. If write some stuff, then MDH-render, then preview, and decide to go back to edit some more... you can't un-render back to Markdown. (It has stripped out the special MDH stuff.)
  • Pasting plaintext seems to lose newlines completely. This is weird and annoying, but actually helps prevent TinyMCE's Pasting vs. Typing confusion.
  • Only the formatting types presented on the Notes' formatting toolbar are supported, at all. If you put a Markdown code block into the edit box and MDH-render it, it will look fine in the editor, but if you preview or publish it, you'll see that it's been stripped out.
  • Italics doesn't work in preview/publish. The italicize button on the Notes' formatting toolbar behaves that same broken way as well. Ctrl+I works, though. It seems that Notes doesn't allow <em> but does allow <i>.
### Google Hangouts

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:

  • The surrounding <p> element makes the little compose box look oddly expanded after rendering. There's no ill effect, though.
  • In Chrome, the chat box has to be popped out of the Gmail page in order for MDH to work. This is because (I think) MDH is loaded into the Gmail page and there are cross-origin restrictions between the top mail.google.com page and the talkgadget.google.com iframe where the chat box is. (See issue #124.)
    • Firefox doesn't have this problem. Opera surely does. Not sure about Safari.
### Tumblr

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

Squarespace is a non-free site creation and hosting service.

MDH ought to work, but looks pretty bad. Needs to be investigated.

### Blackboard Learn

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.

### Editor Tools

There's a whole class of rich editors for use in web pages that Markdown Here woks with.

#### TinyMCE

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.)

##### Pasting vs. Typing

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

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

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

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:

  • Code blocks have a background colour and an outer border. This can probably be defeated with site-specific rules and !important. See the default Primary Styling CSS for an example used with Wordpress.
  • Some other styling stuff.
#### Hallo

Hallo is a simple rich editor. Markdown Here seems to work reasonably well with it.

#### wysihtml5

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

bootstrap-wysihtml5 is based on wysihtml5 for use with the Twitter Bootstrap web toolkit. Markdown Here works well with it as well.

Clone this wiki locally