Markdown les tenants et les aboutissants

Markdown est un langage de balisage étonnamment simple qui vous permet d’écrire en utilisant un format de texte brut facile à lire et à écrire. Ce format peut ensuite, en quelques secondes, être converti dans un autre langage de balisage, tel que HTML!

Si vous ne le connaissez pas, laissez-moi vous en parler aujourd'hui.!

Markdown fait un travail fantastique pour se mettre à l'écart.

Markdown fait un travail fantastique pour se mettre à l'écart. Je suis sûr que tout le monde a, à un moment donné, mis l'accent sur le texte d'un document en texte brut en entourant la phrase d'un astérisque, comme *. C'est exactement comme ça que ça marche dans Markdown! Fournir une emphase supplémentaire (en gras) est aussi simple que ** doubler l'astérisque **.

Il n’est pas surprenant que la philosophie de Markdown soit de produire du contenu, qui peut être "publié tel quel", sans avoir l’impression qu’il a été marqué avec des balises. "

Les avantages devraient être évidents pour quiconque a essayé d'écrire du contenu Web et doit également s'inquiéter de son formatage.. texte ici est tout simplement trop difficile à taper, une fois que votre cerveau est en mouvement - sans parler de la façon dont la frénésie des balises HTML qui gâchent un document peut ruiner la lisibilité lorsque vous corrigez un document.

Un certain nombre d'éditeurs Markdown existent, à la fois sur le Web et sur le bureau, mais vous pouvez bien sûr utiliser n'importe quel ancien éditeur de texte. Le seul avantage que des éditeurs spécifiques de Markdown fournissent est un aperçu en direct du code HTML généré et, en général, un certain niveau de mise en évidence de la syntaxe..

Si vous souhaitez essayer les exemples ci-dessous, reportez-vous au convertisseur officiel basé sur un navigateur Dingus..


Le balisage

Les paragraphes

Avec Markdown, le texte est automatiquement converti en paragraphes dans lesquels des blocs de texte sont séparés par une ligne vierge. Et pas seulement par plusieurs
des balises comme WYSIWYG de l'époque, mais une véritable sémantique

paragraphes. C'est presque comme de la magie noire.

 Lorem ipsum dolor sit amet, consectetur elit adipisicing, promis de faire une incarnation temporelle, et dolore magna aliqua. Tout en un minimum de poids, l’exercice de nos exercices en cours de travail, mais il n’existe que d’excellents résultats. Duis aute irure dolor in reprrehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Devient simplement:

Lorem ipsum dolor sit amet, consectetur elit adipisicing, promis de faire une incarnation temporelle, et dolore magna aliqua. Il enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo conséquat.

Duis aute irure dolor in reprrehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Une petite particularité avec Markdown est la façon dont les sauts de ligne sont gérés. La philosophie de Markdown est que le navigateur doit gérer les sauts de ligne et personne d’autre. Donc le texte suivant:

Lorem ipsum dolor sit amet, consectetur. Admission de l'élite, ne faites que l'incident temporel.

Devient, assez choquant:

Lorem ipsum dolor sit amet, consectetur. Admission de l'élite, ne faites que l'incident temporel.

Si vous absolument doit insérer un saut de ligne, une solution de contournement est fournie: ajoutez simplement deux espaces à la fin de la ligne précédente, comme suit:

Lorem ipsum dolor sit amet, consectetur. Admission de l'élite, ne faites que l'incident temporel.

Un certain nombre de "variantes" de Markdown peuvent gérer les sauts de ligne comme vous l’attendiez, mais nous en parlerons plus tard..

Les rubriques

Commencer un paragraphe avec un #, et ce paragraphe devient un en-tête. Le nombre de # indique le numéro de niveau de la rubrique (

,

etc.)

# Heading One Ceci est un paragraphe. Lorem ipsum dolor sit amet, consectetur elit adipisicing, promis de faire une incarnation temporelle, et dolore magna aliqua. Ut enim ad minim veniam. ## Heading Two Ceci est un paragraphe. Lorem ipsum dolor sit amet, consectetur elit adipisicing, promis de faire une incarnation temporelle, et dolore magna aliqua. Ut enim ad minim veniam. ### Titre Trois #### Titre Quatre ##### Titre Cinq ###### Titre Six

Devient:

Titre un

Ceci est un paragraphe. Lorem ipsum dolor sit amet, consectetur elit adipisicing, promis de faire une incarnation temporelle, et dolore magna aliqua. Ut enim ad minim veniam.

Rubrique deux

Ceci est un paragraphe. Lorem ipsum dolor sit amet, consectetur elit adipisicing, promis de faire une incarnation temporelle, et dolore magna aliqua. Ut enim ad minim veniam.

Rubrique trois

Rubrique quatre

Rubrique cinq
Rubrique six

Une syntaxe alternative est également fournie pour

et

, ainsi:

Heading One =========== Ceci est un paragraphe. Lorem ipsum dolor sit amet, consectetur elit adipisicing, promis de faire une incarnation temporelle, et dolore magna aliqua. Ut enim ad minim veniam. Titre Deux ----------- Ceci est un paragraphe. Lorem ipsum dolor sit amet, consectetur elit adipisicing, promis de faire une incarnation temporelle, et dolore magna aliqua. Ut enim ad minim veniam.

Devis de blocs

L'une des principales influences de Markdown est le courrier électronique en texte brut, ce qui est flagrant lorsque vous voyez que les guillemets sont formatés. exactement comme ils sont dans l'email: préfixé par un >:

Ceci est un paragraphe normal. > Ceci est un paragraphe blockquote. > Et le blockquote continue ici aussi.

… Qui se transforme en:

Ceci est un paragraphe normal.

Ceci est un paragraphe blockquote.

Et le blockquote continue ici aussi.

Code

Vous pouvez supprimer les petits extraits de code en ligne à l’aide de la touche ' caractère autour du code.

Des blocs de code plus grands peuvent être définis simplement en mettant en retrait le code d'un niveau (au moins un onglet / quatre espaces) - le niveau d'indentation sera supprimé. Markdown échappe automatiquement à tous les caractères spéciaux d'un bloc de code, ce qui signifie que vous pouvez simplement copier en toute sécurité des blocs de code sans vous échapper manuellement. < à < et > à > etc.

Ceci est un paragraphe avec un peu de 'CODE'dedans.  Un autre paragraphe, mais avec un bloc de code au dessus.


Ceci est un paragraphe avec un peu de 'CODE'dedans.

 

Un autre paragraphe, mais avec un bloc de code au dessus.

Des listes

Un autre vrai exemple de la manière dont Markdown vient naturellement est la manière dont vous spécifiez une liste. Commencez simplement un paragraphe avec un * (ou +, -) pour créer une liste non ordonnée. Utilisez des chiffres, 1., 2. etc. pour les listes ordonnées:

J'aurai besoin de: * Serpents * Scorpions * Hamsters Ensuite, je peux commencer mon plan pour gouverner le monde: 1. Des hamsters aquires 2. Former des serpents à monter des hamsters 3. Diriger le monde


J'aurai besoin:

  • Serpents
  • Scorpions
  • Hamsters

Ensuite, je peux commencer mon plan pour gouverner le monde:

  1. Hamsters d'Aquire
  2. Former des serpents à chevaucher des hamsters
  3. Dirige le monde

Eléments de texte en ligne

Nous avons déjà traité le texte en italique et en gras au début de cet article (* et **), cependant, vous pouvez également échanger les astérisques contre des traits de soulignement, si cela vous intéresse davantage:

Voici du texte * italique * et plus _italic_. Certains ** trucs audacieux ** ici; plus un peu plus.

Les liens sont simples et agréables dans Markdown (si vous pouvez vous souvenir que ce sont les crochets et les crochets qui viennent en premier…):

[Google] (http://google.com)
Google

Pour afficher une image, préfixez le code du lien avec un !:

![Le logo Google] (images_23 / markdown-the-ins-and-outs.png)
Le logo de Google

Markdown ne vous gêne pas

Markdown est très indulgent quand il s'agit de sortir de son balisage et d'utiliser simplement HTML. Si vous devez inclure un tableau, incluez-le au format HTML. Ou, si vous préférez écrire vos liens au format HTML, vous pouvez le faire. Markdown est assez intelligent pour savoir quand vous voulez inclure du HTML, et ça marche..

Markdown échappe également automatiquement les caractères, tels que &, < and > dans le formulaire d'entité HTML. Il convertit même intelligemment les combinaisons de caractères courantes en ce que vous entendez vraiment..

  • Trois points deviendront automatiquement des points de suspension:…
  • Deux traits d'union vont devenir un en-tiret: --
  • Les guillemets vont devenir des versions "fantaisistes" et frisées.

Arômes et arômes GitHub aromatisés

Il existe un certain nombre de "variantes" de Markdown, qui étendent le jeu de règles de Markdown par défaut. Une extension commune est une rupture de ligne facile, comme décrit ci-dessus. Un des arômes de Markdown les plus connus est Flavored Markdown de GitHub. Ceci est utilisé pour annoter les entrées des utilisateurs partout sur leur site. Outre la prise en charge améliorée des sauts de ligne et un certain nombre de personnalisations spécifiques à GitHub, ma fonctionnalité préférée est leur alternative au fencing de code, qui vous permet également de spécifier une syntaxe pour la surbrillance. Entourez simplement un bloc de code avec " de chaque côté, y compris la langue au début, comme suit:

"php "

Conversion

Le convertisseur Tuts + Markdown est disponible ici.

Le convertisseur officiel est écrit en Perl et peut être téléchargé sur la page d’accueil de Markdown à Daring Fireball. Il existe également plusieurs autres convertisseurs Markdown, pour une multitude de langues - du C… au Ruby… au JavaScript… au PHP. Une liste complète des implémentations peut être trouvée sur Wikipedia.

RedCarpet est une implémentation populaire de Ruby, basée sur la bibliothèque C, Sundown, qui fournit un moyen très simple de personnaliser la sortie du code HTML généré pour produire votre propre "saveur" de Markdown..

Récemment, j'ai utilisé cette bibliothèque pour créer un convertisseur Markdown, qui accepte GitHub Flavored Markdown (pour permettre de spécifier un langage de code pour la coloration syntaxique), et génère le code HTML converti dans le style spécifique requis par les sites Tuts +. Le convertisseur Tuts + Markdown est disponible ici. Si vous avez déjà écrit un tutoriel pour ce site, utilisez le certainement!

En fait, cet article a été écrit dans Markdown à l’aide du célèbre éditeur Mou Markdown pour OSX..