Comment utiliser l’outil Markdown en HTML
- Ajoutez du MarkdownCollez du Markdown dans la zone de gauche, ou déposez ou ouvrez un fichier .md.
- Choisissez le résultatChoisissez « Code HTML seul » pour un CMS ou un site, ou « Page HTML complète » pour un fichier autonome avec styles.
- Vérifiez le résultatLe code HTML se met à jour pendant la saisie. Passez en Aperçu pour voir le rendu.
- Copiez ou téléchargezCopiez le HTML dans le presse-papiers ou téléchargez-le en fichier .html.
Fonctionnalités
- Code propre et lisibleLes éléments de bloc sont sur leur propre ligne et indentés, prêts à coller dans un modèle.
- GitHub Flavored MarkdownTableaux avec alignement, listes de tâches, texte barré, blocs de code et liens automatiques.
- Résultat sûrLes scripts, gestionnaires d’événements et autre HTML dangereux présents dans le Markdown sont supprimés.
- Options de liensAjoutez si vous le souhaitez target="_blank" et rel="noopener" aux liens externes.
Quand convertir du Markdown en HTML
Le Markdown est agréable à écrire, mais les navigateurs, les éditeurs d'e-mails et beaucoup de CMS ont besoin de HTML. En convertissant, vous obtenez un code à coller n'importe où. Les éléments de bloc sont placés sur leurs propres lignes et indentés, prêts pour un modèle.
- Publier un README ou une page de documentation sur un site
- Coller dans WordPress, Blogger ou un outil de newsletter un article écrit dans une application Markdown
- Transformer des notes en page web autonome à partager ou à archiver
- Voir exactement quel HTML produit un morceau de Markdown
Ce que devient chaque élément
| Markdown | HTML |
|---|---|
| # Titre | <h1>Titre</h1> |
| **gras** | <strong>gras</strong> |
| [texte](url) | <a href="url">texte</a> |
| - élément | <ul><li>élément</li></ul> |
| Tableau à barres verticales | <table> avec <thead> et <tbody> |
| Délimiteur ```js | <pre><code class="language-js"> |
Deux types de sortie
« Code HTML seul (pour un CMS ou un site web) » produit des balises propres sans style, pour que le CSS de votre site décide des polices et des couleurs. « Page HTML complète avec styles » produit un document autonome avec un titre et une typographie lisible, qui s'affiche joliment dans le navigateur. Avec « Ouvrir les liens dans un nouvel onglet », les liens externes reçoivent target="_blank" et rel="noopener". Les scripts, gestionnaires d'événements et autres morceaux de HTML dangereux présents dans le Markdown sont retirés.
Accents et encodage
Les caractères accentués, la cédille, les ligatures œ et æ et les guillemets « » sont écrits tels quels dans le HTML, sans entités : c'est la bonne pratique aujourd'hui, à condition que la page soit servie en UTF-8. La page complète téléchargée contient déjà <meta charset="utf-8">. Si, une fois collé dans votre site, le texte affiche « é » à la place de « é », le problème vient de l'encodage du site, pas du HTML : vérifiez qu'il déclare bien l'UTF-8.
Problèmes courants et solutions
- Une liste sort en un long paragraphe : le Markdown a besoin d'une ligne vide avant le premier élément. Ajoutez-la au-dessus de la liste.
- Les retours à la ligne disparaissent : un simple retour dans un paragraphe compte comme une espace. Laissez une ligne vide pour un nouveau paragraphe, terminez la ligne par deux espaces ou activez « Retours à la ligne comme dans le texte ».
- Des astérisques ou des tirets bas apparaissent : * et _ déclenchent la mise en forme. Mettez une barre oblique inverse devant (\*) pour afficher le caractère.
- Un tableau n'est pas converti : il lui faut une ligne d'en-tête, une ligne de tirets juste en dessous et le même nombre de colonnes sur toutes les lignes.
- Le HTML est trop simple sur mon site : c'est normal, le code ne contient pas de style. Si vous voulez un fichier qui s'affiche joliment seul, téléchargez la page complète.
Avant de coller le HTML dans un CMS comme WordPress, passez l'éditeur en mode code ou utilisez un bloc « HTML personnalisé » ; dans l'éditeur visuel, les balises s'afficheraient en texte. Pour écrire avec aperçu et enregistrement automatique, utilisez l'Éditeur Markdown, et pour le sens inverse, HTML en Markdown.