markdown here Télécharger - markdown here Téléchargement du code source

markdown here

Autre code source

v2.14.2

Télécharger

Démarquage ici

Visitez le site Web.
Obtenez-le pour Chrome.
Obtenez-le pour Firefox.
Obtenez-le pour Safari.
Obtenez-le pour Thunderbird.
Obtenez-le pour Opera.
Discutez-en et posez des questions dans les discussions GitHub.

Markdown Voici une extension Google Chrome, Firefox, Safari, Opera et Thunderbird qui vous permet d'écrire des e-mails ^† dans Markdown ^‡ et de les restituer avant de les envoyer. Il prend également en charge la coloration syntaxique (spécifiez simplement la langue dans un bloc de code clôturé).

Écrire un e-mail contenant du code est assez fastidieux. Écrire du Markdown avec du code est facile. Je me suis retrouvé à écrire un e-mail dans Markdown dans l'éditeur intégré au navigateur GitHub, puis à copier l'aperçu dans un e-mail. Il s'agit d'un flux de travail assez absurde, j'ai donc décidé de créer un outil pour écrire et afficher Markdown directement dans l'e-mail.

Pour découvrir ce qui peut être fait avec Markdown dans Markdown Here , consultez la feuille de triche Markdown Here et les autres pages wiki.

^{† : Et les publications de Google Groupes, les publications de Blogger, les notes Evernote et les publications Wordpress ! Voir plus.}
^{‡ : Et les formules mathématiques TeX !}

Table des matières

Instructions d'installation
Instructions d'utilisation
Dépannage
Compatibilité
Notes et divers
Construire les bundles d'extensions
Étapes suivantes, crédits, commentaires, licence

Instructions d'installation

Chrome

Chrome Web Store

Accédez à la page Chrome Web Store pour Markdown Here et installez normalement.

Après l'installation, assurez-vous de recharger votre webmail ou de redémarrer Chrome !

Manuel/Développement

Clonez ce dépôt.
Dans Chrome, ouvrez les paramètres des extensions. (Bouton clé, Outils, Extensions.)
Sur la page des paramètres des extensions, cochez la case « Mode développeur ».
Cliquez sur le bouton désormais visible « Charger l'extension décompressée … ». Accédez au répertoire dans lequel vous avez cloné le dépôt, puis au répertoire src en dessous.
L'extension Markdown Here devrait maintenant être visible dans votre liste d'extensions.
Rechargez votre page de messagerie Web (et peut-être votre application) avant d'essayer de convertir un e-mail.

Firefox et Thunderbird

Site de modules complémentaires Mozilla

Accédez à la page des modules complémentaires Firefox pour Markdown ici et installez normalement.

Ou allez dans le menu « Outils > Modules complémentaires », puis recherchez « Markdown Here ».

Après l'installation, assurez-vous de redémarrer Firefox/Thunderbird !

Remarque : Il faut jusqu'à un mois à Mozilla pour approuver les modifications apportées à l'extension Firefox/Thunderbird, donc les mises à jour (fonctionnalités, correctifs) seront en retard par rapport à ce qui est affiché ici. Vous pouvez choisir manuellement d'installer la version la plus récente avant qu'elle ne soit examinée dans la liste des versions : https://addons.mozilla.org/en-US/firefox/addon/markdown-here/versions/

Manuel/Développement

Clonez ce dépôt.
Suivez les instructions de l'article MDN « Votre première WebExtension ».

Safari

Téléchargez directement l'extension. Une fois le téléchargement terminé, double-cliquez dessus pour l'installer.

Préférences

Pour accéder aux préférences Markdown Here, ouvrez les préférences Safari puis allez dans l'onglet "Extensions". Cliquez ensuite sur la case « Cliquez sur moi pour afficher les options Markdown ici ».

Opéra

Notez que Markdown Here ne fonctionne qu'avec les versions 16 et supérieures d'Opera (c'est-à-dire celles basées sur Chromium).

Accédez à la page de la boutique Opera Add-ons pour Markdown Ici et installez normalement.

Après l'installation, assurez-vous de recharger votre webmail ou de redémarrer Chrome !

Instructions d'utilisation

Installez-le, et puis…

Dans Chrome/Safari/Opera, assurez- vous de recharger votre page de messagerie Web avant d'essayer d'utiliser Markdown Here.
Dans Chrome/Firefox/Safari/Opera, connectez-vous à votre compte Gmail, Hotmail ou Yahoo et démarrez un nouvel e-mail. Dans Thunderbird, démarrez un nouveau message.
Assurez-vous que vous utilisez l'éditeur riche.
- Dans Gmail, cliquez sur le lien "Mise en forme enrichie", s'il est visible.
- Dans Thunderbird, assurez-vous que « Rédiger des messages au format HTML » est activé dans le volet « Paramètres du compte », « Composition et adressage ».

Composez un e-mail dans Markdown. Par exemple:

 **Bonjour** `monde`.

```javascript
alert('Bonjour la coloration syntaxique.');
```

Faites un clic droit dans la zone de rédaction et choisissez l'élément "Markdown Toggle" dans le menu contextuel. Ou cliquez sur le bouton qui apparaît dans votre barre d'adresse. Ou utilisez le raccourci clavier ( CTRL + ALT + M par défaut).
Vous devriez voir votre e-mail rendu correctement de Markdown en HTML riche.
Envoyez votre superbe e-mail à tous ceux que vous connaissez. Il leur apparaîtra de la même manière qu’à vous.

Revenir à Markdown

Après avoir rendu votre Markdown en joli HTML, vous pouvez toujours revenir à votre Markdown d'origine. Faites simplement un clic droit n'importe où dans le Markdown nouvellement rendu et cliquez sur "Markdown Toggle" - le corps de la composition de votre e-mail reviendra au Markdown que vous aviez écrit.

Notez que toutes les modifications que vous apportez au joli code HTML seront perdues lorsque vous reviendrez à Markdown.

Dans Gmail, vous pouvez également utiliser la commande Annuler du navigateur ( CTRL + Z / CMD + Z , ou depuis le menu Edition). Soyez averti que vous risquez également de perdre les derniers caractères que vous avez saisis.

Réponses

Dans Gmail, Thunderbird et Google Groupes, vous pouvez normalement utiliser « Markdown Toggle » : écrivez simplement votre réponse (en haut, en bas, en ligne, n'importe où), puis convertissez-la. L'e-mail d'origine auquel vous répondez sera laissé tel quel. (Techniquement : les blocs blockquote existants seront laissés intacts.)

Dans Hotmail et Yahoo (qui ne mettent pas l'original entre blockquote ), et éventuellement dans Gmail, Thunderbird et Google Groupes, vous pouvez vous assurer que seule la partie de la réponse que vous avez écrite est convertie en sélectionnant ce que vous souhaitez convertir. puis en cliquant sur "Markdown Toggle" - voir la section suivante.

Sélection/Conversion au coup par coup

Parfois, vous ne souhaitez pas convertir l'intégralité de l'e-mail ; Parfois, votre e-mail n'est pas entièrement Markdown. Pour convertir seulement une partie de l'e-mail, sélectionnez le texte (avec votre souris ou votre clavier), faites un clic droit dessus et cliquez sur l'élément de menu "Markdown Toggle". Votre sélection est rendue comme par magie dans un joli HTML.

Pour revenir à Markdown, placez simplement votre curseur n'importe où dans le bloc de texte converti, faites un clic droit et cliquez à nouveau sur l'élément de menu "Markdown Toggle". Maintenant, nous revenons comme par magie au Markdown original.

Ce qu'il faut savoir sur la conversion/l'annulation d'une sélection

Si vous sélectionnez seulement une partie d'un bloc de texte, seul ce texte sera converti. Le bloc converti sera enveloppé dans un élément de paragraphe, de sorte que la ligne d'origine sera divisée. Vous ne voulez probablement jamais faire ça.
Vous pouvez sélectionner et annuler plusieurs blocs convertis en même temps. L'un des résultats est que vous pouvez sélectionner l'intégralité de votre e-mail, cliquer sur "Markdown Toggle" et toutes les parties que vous aviez converties seront rétablies.
Si rien n'est sélectionné lorsque vous cliquez sur "Markdown Toggle", Markdown Here vérifiera s'il y a des blocs convertis n'importe où dans le message et les annulera. Si aucun bloc converti n’est trouvé, l’intégralité de l’e-mail sera convertie.

Possibilités

La page Options Markdown Here est accessible via la liste des extensions Chrome, Firefox, Safari ou Thunderbird. Les options disponibles incluent :

Modifications de style pour le rendu Markdown.
Syntaxe mettant en évidence la sélection et la modification du thème.
Activation et personnalisation du traitement des formules mathématiques TeX.
Quel devrait être le raccourci clavier.

Pour Chrome et Firefox, toutes les modifications apportées aux options Markdown Here sont automatiquement synchronisées entre vos autres installations de ce navigateur (si la fonction de synchronisation est activée dans le navigateur).

Dépannage

Consultez la page wiki de dépannage.

Compatibilité

Voir la page wiki Compatibilité.

Notes et divers

Markdown Here utilise Github Flavored Markdown, avec la limitation que les liens spéciaux GFM ne sont pas pris en charge (problème n°11) ; ils ne le seront pas non plus, car MDH n'est pas spécifique à Github.
Les langages disponibles pour la coloration syntaxique (et la manière dont ils doivent être écrits dans le bloc de code clôturé) peuvent être consultés sur la page de démonstration highlight.js.
Les images intégrées en ligne dans votre Markdown seront conservées lorsque vous "Markdown Toggle". Gmail vous permet d'insérer des images dans votre courrier électronique. Cela peut être beaucoup plus simple que de référencer une image externe.
Les signatures électroniques sont automatiquement exclues de la conversion. Plus précisément, tout ce qui se trouve après le semi-standard '-- ' (notez l'espace de fin) est laissé seul.
- Notez que Hotmail et Yahoo n'ajoutent pas automatiquement le '-- ' aux signatures, vous devez donc l'ajouter vous-même.
L'élément de menu « Markdown Toggle » apparaît pour plus de types d'éléments qu'il ne peut restituer correctement. Ceci est destiné à aider les gens à réaliser qu'ils n'utilisent pas un éditeur riche. Sinon, ils ne voient tout simplement pas l'élément de menu et ne savent pas pourquoi.
Style :
- L'utilisation de styles spécifiques au navigateur (-moz-, -webkit-) doit être évitée. S'ils sont utilisés, ils risquent de ne pas s'afficher correctement pour les personnes lisant l'e-mail dans un navigateur différent de celui dans lequel l'e-mail a été envoyé.
- L'utilisation de styles dépendants de l'état (comme a:hover ) ne fonctionne pas car ils ne correspondent pas au moment où les styles sont rendus explicites. (Dans les e-mails, les styles doivent être explicitement appliqués à tous les éléments – les feuilles de style sont supprimées.)
Pour des fonctionnalités plus avancées, visitez la section Trucs et astuces.

Construire les bundles d'extensions

 cd utils
node build.js

Extension Chrome, Opera et Firefox (WebExtension)

Créez un fichier avec une extension .zip contenant ces fichiers et répertoires :

 manifest.json
common/
chrome/
_locales

Extension Thunderbird (XUL)

Créez un fichier avec une extension .xpi contenant ces fichiers et répertoires :

 chrome.manifest
install.rdf
common/
firefox/

Extension Safari

Le code spécifique au navigateur se trouve dans le projet markdown-here-safari .

Utilisez le générateur d'extensions Safari.

Prochaines étapes

Consultez la liste des problèmes et le wiki Notes. Toutes les idées, bugs, plans, plaintes et rêves finiront dans l’un de ces deux endroits.

N'hésitez pas à créer un problème de demande de fonctionnalité si ce que vous souhaitez n'est pas déjà là. Si vous préférez une approche moins formelle pour lancer une idée, publiez-la sur nos discussions GitHub.

Il faut également beaucoup de travail pour rester au courant des dernières modifications apportées à toutes les applications et sites Web sur lesquels Markdown Here fonctionne.

Crédits

Markdown Here a été codé sur les épaules de géants.

Markdown vers HTML : chjj/marked
Mise en évidence de la syntaxe : isagalaev/highlight.js
HTML vers texte : mtrimpe/jsHtmlToText

Retour

Tous les bugs, demandes de fonctionnalités, demandes d'extraction, commentaires, etc., sont les bienvenus. Créez un problème. Ou publiez sur nos discussions GitHub.