Utiliser Markdown pour une rédaction Web facile

  • Dominick Harrison
  • 0
  • 1085
  • 96

Récemment, en écoutant une série de podcasts centrés sur le Mac, en particulier sur les workflows avec le Mac, je suis tombé sur un outil qui existe depuis un moment mais qui n’est toujours pas très populaire. L'outil s'appelle Markdown et a été créé par John Gruber (renommée de Daring Fireball). La meilleure façon de l'expliquer est le premier paragraphe de la description de Markdown sur la page de M. Gruber:

Markdown est un outil de conversion de texte en HTML destiné aux rédacteurs Web. Markdown vous permet d’écrire en utilisant un format de texte brut facile à lire et à écrire, puis de le convertir en XHTML (ou HTML) structurellement valide..

Ouais c'est ça en quelques mots. Avant de vous expliquer comment utiliser cet outil génial sur Mac et Windows, vous vous demandez peut-être à quoi sert un outil comme celui-ci..

À quoi ça sert?

Au début, je n'ai pas compris le motif de l'utilisation de Markdown. Cool, vous pouvez transférer du texte brut en HTML, mais qui diable utilise maintenant le HTML? Eh bien, si vous êtes un rédacteur Web, vous utilisez le langage HTML tous les jours, que vous le sachiez ou non, et si vous utilisez WordPress ou tout autre système de gestion de contenu depuis un certain temps, vous avez sans doute dû modifier un peu le code HTML..

Si vous utilisez WordPress, rien de plus agréable que l'éditeur WYSIWYG ne soit trop utile avec les balises HTML en arrière-plan, essentiellement pour déstocker votre mise en forme. Markdown peut vous aider en transformant votre fichier texte en HTML valide. Cela vous permet de coller votre code HTML dans l'éditeur HTML tout en conservant votre formatage durement gagné. Vraiment gentil. La publicité

De plus, il y a quelque chose à dire sur la portabilité des documents. Le HTML est un type de balisage de document agnostique et peut être rendu dans à peu près tout navigateur Web de merde. Compte tenu de l'utilisation continue de nombreux systèmes d'exploitation et périphériques (iOS, Android, Blackberry, Windows, Mac, Linux, etc.), il est indispensable de disposer d'un format de texte standard. Markdown vous aide à cela en vous permettant de normaliser tout le formatage de vos notes sans vous cantonner à un format propriétaire. Juste des fichiers HTML et txt.

Utilisons-le, allons-nous?

Markdown est diablement facile à utiliser et si vous avez une expérience quelconque en matière de logiciels et de HTML, ce sera un jeu d'enfant. Markdown est écrit en Perl. Si vous n'avez pas Perl sur votre ordinateur Windows, vous pouvez télécharger et installer Strawberry Perl à partir d'ici. Si vous êtes un utilisateur Mac, Perl est déjà installé pour vous..

Lire la suite

10 petits changements pour que votre maison se sente comme une maison
Qu'est-ce qui rend les gens heureux? 20 secrets de personnes «toujours heureuses»
Comment améliorer vos compétences transférables pour une carrière rapide
Faites défiler vers le bas pour continuer à lire l'article

Ensuite, allez sur Daring Fireball et récupérez le script Markdown.pl, décompressez-le et placez le fichier Markdown.pl dans le répertoire que vous utiliserez pour créer et transformer vos fichiers texte d'entrée..

Maintenant la partie amusante; apprendre à utiliser la syntaxe et créer votre fichier texte d'entrée.

Syntaxe de Markdown

Je vais expliquer brièvement quelques-uns des extraits de syntaxe les plus utilisés qui vous éviteront de courir avec Markdown. Si vous voulez tout le Shebang, allez sur Daring Fireball pour obtenir une liste détaillée de toutes les finesses de la syntaxe de Markdown..

En-têtes

Les balises d'en-tête (h1, h2, h3, etc.) sont simples à créer dans votre document texte. Pour signifier la balise h1, “souligner” le texte avec le signe '=': publicité

Ceci est un en-tête h1 ==================== 

ou pour h2, utilisez le caractère '-':

Ceci est un en-tête h2 ------------------- 

Vous n'avez pas besoin de mettre le même nombre de caractères '=' ou '-' sous l'en-tête. n'importe quel nombre devra produire les balises d'en-tête.

Balles et listes

Je pense que dans les puces et les listes, il est bon que Markdown les gère bien. Pour insérer une puce, ajoutez un astérisque à votre ligne comme ceci:

* C'est mon point 

Vous pouvez également utiliser les caractères '+' ou '-' comme puces.

Les listes commandées sont aussi faciles:

1. Numéro un 2. Numéro deux 3. Numéro trois… maintenant vous l'avez! 

Si vous voulez plusieurs paragraphes sous une puce ou un chiffre, indiquez simplement la première ligne de chaque paragraphe ou indentez toutes les lignes si vous voulez que le tout soit plus joli: Publicité

1. Voici le premier point que j'essaie de faire valoir au sujet des listes numérotées. En passant, je devrais probablement mentionner cela aussi. 2. Point suivant 

Liens

Une des choses que je préfère de Markdown est le moyen facile d’insérer des liens. Tout d’abord, mettez entre crochets le mot ou la phrase que vous souhaitez utiliser. “cliquable” puis suivez cela par une URL entre parenthèses:

[cliquez ici] (http://www.google.com/) 

Sortie en HTML

Après avoir créé votre fichier texte, il est maintenant temps de le transmettre au script Markdown.pl pour générer votre sortie HTML. Si vous n'avez pas créé de fichier texte à tester, vous pouvez télécharger le fichier texte rapide que j'ai créé pour l'essayer..

Placez votre fichier texte dans le même répertoire que le script Markdown.pl (vous pouvez passer les arguments avec le chemin correct si vous le souhaitez, ceci pour faciliter les choses). Ensuite, ouvrez votre invite de commande sous Windows ou votre terminal sur votre Mac ou Linux et naviguez jusqu'au dossier contenant votre fichier d'entrée..

Pour créer la sortie directement dans la fenêtre du terminal, utilisez la commande suivante:

perl Markdown.pl input.txt

Cela analysera ensuite le fichier texte et générera le balisage HTML valide vers le terminal. Si vous souhaitez que la sortie soit dirigée vers un fichier HTML totalement séparé, tapez la commande suivante: Advertising

perl Markdown.pl input.txt> output.html

Cela va créer le fichier HTML output.html dans le répertoire dans lequel vous vous trouvez actuellement.

Envelopper

Laissez-moi juste dire que si vous pensez que Markdown est intéressant et comprenez son utilité, je suggère fortement que si vous écrivez quelque chose, vous devriez l'écrire avec Markdow.

n syntaxe. Il est multi-plateforme, open source, gratuit et compatible avec tout. Pour moi, cela change la donne et je sens que je suis un peu en retard pour ne pas l'utiliser plus tôt. Encore une fois, la syntaxe est bien plus complexe que ce que j’ai souligné ici, alors consultez Daring Fireball pour en savoir plus..

A propos, j’ai écrit tout cet article en utilisant Markdown et si vous voulez voir la syntaxe, vous pouvez le télécharger ici.




Personne n'a encore commenté ce post.

Une aide, des conseils et des astuces qui peuvent améliorer tous les aspects de votre vie.
Une énorme source de connaissances pratiques sur l'amélioration de la santé, la recherche du bonheur, l'amélioration des performances, la résolution de problèmes personnels, etc.