Présentation de Markdown sur OS X

Screencast

Markdown est une syntaxe de mise en forme qui vous permet d’écrire du texte brut pouvant être converti en HTML sans avoir à écrire des millions de chevrons. Markdown utilise des symboles pour indiquer les balises HTML courantes telles que les en-têtes, les caractères de soulignement et les liens. Il a également été étendu avec des efforts tels que MultiMarkdown qui offre un support pour plus d’options de formatage telles que le format RTF (Rich Text Format)..

Dans ce tutoriel, je vais vous présenter Markdown, expliquer pourquoi c'est génial et comment commencer à l'utiliser sur OS X.

Présentation de Markdown

Markdown a été créé par John Gruber de Daring Fireball. Il a été conçu pour format de texte brut facile à lire et à écrire qui pourrait être converti en structurellement valide HTML. La principale caractéristique de Markdown est qu'un document écrit dans la syntaxe est lisible tel quel; vous n'avez même pas besoin de comprendre Markdown, les balises ont un sens.

Markdown a été développé par différentes personnes pour ajouter des fonctionnalités non prises en charge par la version d'origine. MultiMarkdown de Fletcher T. Penney est l’une des extensions les plus couramment utilisées. Il s’est concentré sur l’extension de Markdown afin qu’il puisse être utilisé pour écrire des documents hors ligne au lieu de HTML. Lorsqu'une application prétend prendre en charge Markdown, c'est souvent l'extension MultiMarkdown qu'elle prend en charge..

À l’origine, Markdown comportait deux parties: la syntaxe et l’outil de conversion. La prise en charge de Markdown signifie toutefois qu’il n’est pas nécessaire d’utiliser une ligne de commande pour convertir des documents au format HTML. Au lieu de cela, Markdown est pris en charge dans une grande variété d'applications et de services Web..

Raisons d'utiliser Markdown

La meilleure chose à propos de Markdown est qu’il est extrêmement facile d’écrire du texte mis en forme. Si vous avez lu l'un de mes tutoriels précédents, vous vous êtes peut-être rendu compte que j'aime faire les choses efficacement. Choisir une taille de police et un style dans un menu déroulant chaque fois que vous souhaitez créer un en-tête, puis modifier le contenu du corps du texte n’est pas efficace. Markdown vous permet de formater votre texte avec des caractères simples.

Markdown vous permet d’écrire ce que vous voulez en texte clair facile à lire et qui peut être converti à votre guise. Je peux rédiger une réponse par courrier électronique dans Markdown et la convertir au format RTF. Si je pense que ma réponse par e-mail mérite d'être transformée en un article de blog, je peux convertir le même Markdown en HTML. Cette flexibilité est l’une des choses qui a gagné tant de fans chez Markdown.

Markdown est juste du texte brut. Vous pouvez ouvrir et lire des documents Markdown sur n’importe quel ordinateur. Il n'utilise pas de format de fichier propriétaire comme Microsoft Word, vous n'avez donc pas à vous inquiéter si la version la plus récente d'Office est installée sur l'ordinateur d'un ami uniquement pour accéder à quelque chose que vous avez écrit..

Il y a beaucoup d'autres raisons d'utiliser Markdown. Ce ne sont là que quelques-unes des raisons pour lesquelles je l’utilise. Si vous commencez à utiliser Markdown, vous développerez rapidement votre propre liste.!

La syntaxe de Markdown

La plupart des documents HTML sont composés relativement simples. Les principales options de formatage utilisées sont:

  • en-têtes (d'un ou plusieurs niveaux)
  • paragraphes
  • liens
  • listes à puces
  • balises de texte accentuées ou fortes

Pour ce tutoriel, je vais me concentrer sur ces options de formatage les plus importantes. Si vous êtes intéressé par des notes de bas de page, des tableaux, des citations et d'autres fonctionnalités plus spécialisées de Markdown et de MultiMarkdown, consultez le guide de Gruber sur la syntaxe de Markdown et le guide de l'utilisateur de MultiMarkdown..

Pointe: Dans Markdown, les lignes et les espaces ont une signification. Par exemple, un en-tête doit figurer sur une nouvelle ligne et pour séparer les paragraphes, une ou plusieurs lignes vides sont utilisées.

En-têtes

Balises d'en-tête,

,

, etc. sont principalement écrits dans Markdown en utilisant le symbole #. Pour écrire un en-tête, commencez une nouvelle ligne avec un ou plusieurs # suivis du texte de l’en-tête. Le nombre de # que vous utilisez détermine le niveau d'en-tête. # résultats dans un

tag alors que ### donne un

étiquette.

# Header One ### Header Three devient… 

En-tête un

En-tête trois

Les paragraphes

Tags de paragraphe

 sont ajoutés à tous les blocs de texte auxquels aucune balise n’a été affectée. Pour diviser un document en plusieurs paragraphes, vous devez laisser une ligne vide entre chaque paragraphe de texte..

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod invidunt temporaire ut labore et dolore magna aliquyam erat, sed diam voluptua. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod invidunt temporaire ut labore et dolore magna aliquyam erat, sed diam voluptua. devient… 

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod invidunt temporaire jusqu’à labore et dolore magna aliquyam erat, sed diam voluptua.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod invidunt temporaire jusqu’à labore et dolore magna aliquyam erat, sed diam voluptua.

Liens

Dans Markdown, il existe deux manières d'écrire des liens: inline et reference. Je préfère utiliser la méthode en ligne, je pense que c'est plus propre et plus facile à utiliser, donc je vais me concentrer dessus. Si vous êtes intéressé par les liens de référence, jetez un coup d'œil aux spécifications de Markdown. Pour écrire un lien, entourez le texte entre crochets. Immédiatement après le crochet de fermeture, ajoutez l'URL du lien entre parenthèses..

[Tuts +] (http://tutsplus.com) devient… Tuts+

Listes à puces

Pour écrire une liste à puces dans Markdown, vous pouvez utiliser un astérisque, un symbole plus ou un trait d'union. Mettez chaque élément de la liste sur une nouvelle ligne et commencez-le par le symbole de votre choix suivi d'un espace, puis de l'élément que vous listez..

* Ceci est * une liste * d'objets devient… 
  • C'est
  • une liste
  • des articles

Texte souligné et fort

Markdown prend en charge les deux balises d'emphase et des étiquettes fortes . Pour écrire des étiquettes d’accentuation, insérez un seul astérisque ou soulignez l’un des côtés du texte souligné. Pour écrire des balises fortes, utilisez plutôt des doubles astérisques ou des traits de soulignement..

Ceci est * souligné * et ceci est ** fort ** devient… c’est souligné et c'est fort

Écrire et exporter Markdown avec Byword

J'écris ce tutoriel en Byword. Je sais pertinemment que le rédacteur en chef de Computer Tuts +, Johnny Winter, écrit tout le sien. Byword se présente comme Edition de texte simple et efficace pour Mac, iPhone et iPad et à la hauteur de cette promesse. 

Byword vous fournit un flux de travail complet de Markdown. Vous utilisez Byword comme n'importe quel autre éditeur de texte. Toutefois, lorsque vous tapez des caractères qui symbolisent quelque chose dans Markdown, Byword fournit un aperçu en direct: les en-têtes sont en gras, les URL des liens apparaissent en gris plus clair de manière à ne pas nuire à la lecture du texte. devient en italique.

Écrire ce tutoriel en Byword.

Lorsque vous avez terminé d'écrire et souhaitez exporter votre travail, sélectionnez Fichier> Exporter> Copier HTML ou Fichier> Exporter> Copier le texte enrichi en fonction de ce que vous voulez. Collez ensuite le HTML ou le texte enrichi où vous en avez besoin.

Byword est disponible sous OS X et iOS pour vous permettre de vivre une expérience cohérente sur tous vos appareils. Disponible dans le Mac App Store.

Le principal concurrent de Byword est iA Writer, qui offre également un flux de travail complet, des fonctionnalités très similaires et des applications pour Mac et iOS. Il est également disponible sur le Mac App Store..

Autres applications Markdown

Si vous avez besoin d'options d'exportation plus puissantes que celles proposées par Byword, Marked 2 est souvent considéré comme la référence absolue. Vous ne pouvez pas écrire directement dans Marked 2, c’est juste un aperçu et un exportateur. Pour travailler avec Marked 2, ouvrez le même fichier dans l'éditeur de texte de votre choix et avec Marked 2. Lorsque vous entrez du texte dans votre éditeur de texte ou que vous vous déplacez dans le document, Marked 2 le détectera et mettra à jour l'aperçu en direct.. 

Marqué 2 vous permet d’exporter vos fichiers Markdown au format HTML, Word et PDF. Vous pouvez également configurer l'aperçu pour qu'il reflète le CSS de votre site Web afin que vous puissiez avoir un aperçu en direct de l'apparence de vos billets de blog lorsque vous les publiez en ligne..

Si vous aimez tenir un journal, l'application de journalisation populaire Day One prend en charge Markdown. Au lieu de devoir exporter, Day One affiche automatiquement Markdown en texte enrichi lorsque vous n'écrivez ou ne modifiez pas une entrée..

Modification d'une entrée du premier jour dans Markdown suivie de l'affichage du résultat par le premier jour.

nvALT 2 est une application de prise de notes qui prend en charge Markdown. C'est une fourchette de Notational Velocity que Jonathon vous a montré comment utiliser dans un système de notes à base de texte. Alors que Velocity Notation ne supporte pas Markdown par défaut, le fork de nvALT 2 ne.

Services Web

Comme Markdown a été conçu à l'origine pour l'écriture Web, certains systèmes de gestion de contenu majeurs, ou CMS, le prennent en charge immédiatement ou avec un plugin..

Squarespace, solution que le didacticiel de Jordan vous explique comment le configurer, prend en charge Markdown dans son éditeur de site par défaut..

Wordpress ne prend pas en charge Markdown par défaut, mais de nombreux plug-ins vous permettent de l'ajouter. J'utilise Jetpack Markdown pour mon propre site Wordpress.

Enfin, Markdown Dingus, le logiciel original de John Gruber, est un service Web qui vous permet de convertir facilement du texte Markdown en HTML. Pour l'utiliser, copiez ou tapez Markdown texte dans l'éditeur et cliquez sur Convertir. Vous pouvez ensuite copier et coller l'export HTML où vous en avez besoin.

Conclusion

Dans ce tutoriel, je vous ai montré comment écrire avec la syntaxe Markdown et expliqué pourquoi Markdown est génial. Je vous ai également montré comment écrire et modifier Markdown dans Byword et j'ai examiné quelques-unes des nombreuses applications et sites Web prenant en charge Markdown..

Si vous avez un éditeur ou un flux de production Markdown favori, merci de me le faire savoir dans les commentaires..