Utilizzare Markdown per una facile scrittura Web

Nell'ascoltare un sacco di podcast Mac-centric ultimamente, specialmente sui flussi di lavoro con il Mac, ho trovato uno strumento che è stato in giro per un po ', ma non è ancora estremamente popolare tra tutti. Lo strumento si chiama Markdown ed è stato creato da John Gruber (la fama di Daring Fireball). Il modo migliore per spiegarlo è il primo paragrafo della descrizione di Markdown sulla pagina di Mr. Gruber:

Markdown è uno strumento di conversione da testo a HTML per i web writer. Markdown ti permette di scrivere usando un formato di testo semplice di facile lettura, facile da scrivere, quindi convertilo in XHTML (o HTML) valido dal punto di vista strutturale.

Sì, questo è in poche parole. Prima di saltare a usare questo fantastico strumento su Mac e Windows, ci si potrebbe chiedere quale sia il vero significato di uno strumento come questo.

Qual e il punto?

All'inizio non ho capito il motivo dell'utilizzo di Markdown. Fantastico, puoi trasferire elementi di testo in HTML, ma chi diavolo usa più l'HTML? Beh, se sei un web writer usi l'HTML ogni singolo giorno, che tu lo sappia o no e se hai usato WordPress o qualsiasi altro CMS per un periodo di tempo che molto probabilmente hai dovuto modificare un po 'di HTML.

Se stai usando WordPress non c'è nulla di più accattivante di quanto l'editor WYSIWYG diventi troppo utile con i tag HTML in background che essenzialmente indirizzano la tua formattazione. Markdown può aiutarti trasformando il tuo file di testo in HTML valido. Ciò ti consente di incollare il tuo codice HTML nell'editor HTML mantenendo così la tua formattazione vincente. Così carino. Pubblicità

Inoltre, c'è qualcosa da dire per la portabilità del documento. L'HTML è un tipo agnostico di markup del documento e può essere visualizzato in quasi tutti i browser Web scadenti. Con l'uso continuato di molti sistemi operativi e dispositivi diversi in natura (iOS, Android, Blackberry, Windows, Mac, Linux, ecc.) È assolutamente necessaria la necessità di un formato standard per il testo. Markdown ti aiuta in questo modo permettendoti di standardizzare tutta la formattazione della nota senza bloccarti in un formato proprietario. Solo file HTML e txt.

Usiamolo, dobbiamo?

Markdown è abbastanza facile da usare e se hai qualche esperienza con il software e HTML, sarà un gioco da ragazzi. Markdown è scritto in Perl, quindi se non hai Perl sulla tua macchina Windows puoi scaricare e installare Strawberry Perl da qui. Se sei un utente Mac, Perl è già installato per te.

Leggi Successivo

10 piccole modifiche per far sentire la tua casa come una casa

Cosa rende felici le persone? 20 segreti delle persone "sempre felici"

Come affinare le tue abilità trasferibili per un interruttore di carriera rapido

Scorri verso il basso per continuare a leggere l'articolo

Successivamente, vai su Daring Fireball e prendi lo script Markdown.pl, decomprimilo e inserisci il file Markdown.pl nella directory che userai per creare e trasformare i tuoi file di testo di input.

Ora la parte divertente; imparare come utilizzare la sintassi e creare il tuo file di testo di input.

Sintassi Markdown

Spiegherò brevemente alcuni degli snippet di sintassi più usati che ti metteranno alla prova con Markdown. Se vuoi l'intera shebang, vai su Daring Fireball per ottenere un elenco dettagliato di tutte le sottigliezze della sintassi Markdown.

intestazioni

I tag di intestazione (h1, h2, h3, ecc.) Sono semplici da creare nel documento di testo. Per significare il tag h1, “sottolineare” il testo con il segno "=": pubblicità

Questo è un header h1 =================== 

oppure per h2 usa il carattere '-':

Questa è un'intestazione h2 ------------------- 

Non è necessario inserire la stessa quantità di caratteri '=' o '-' sotto l'intestazione; qualsiasi numero produrrà i tag di intestazione.

Elenchi puntati e elenchi

Penso ai proiettili e alle liste, quindi è bello che Markdown li gestisca bene. Per inserire un pallino, aggiungi un asterisco alla tua linea in questo modo:

* Questo è il mio punto 

Puoi anche utilizzare i caratteri "+" o "-" come punti elenco.

Anche gli elenchi ordinati sono facili:

1. Numero uno 2. Numero due 3. Numero tre ... ora ce l'hai! 

Se vuoi più paragrafi sotto una pallottola o un numero, rientra nella prima riga di ogni paragrafo o rientra tutte le righe se vuoi che appaia più bello: Pubblicità

1. Ecco il primo punto che sto cercando di fare sulle liste numerate. A proposito, dovrei probabilmente menzionare anche questo. 2. Punto successivo 

link

Una delle cose che preferisco di Markdown è il modo semplice per inserire link. Innanzitutto, raggruppa la parola o la frase che vorresti essere “cliccabile” e poi seguirlo con un URL tra parentesi:

[clicca qui] (http://www.google.com/) 

Uscita in HTML

Dopo aver creato il file di testo, è giunto il momento di passarlo allo script Markdown.pl per produrre l'output HTML. Se non hai creato un file di testo da testare, puoi scaricare il file di testo rapido che ho creato per provarlo.

Inserisci il tuo file di testo nella stessa directory dello script Markdown.pl (puoi passare gli argomenti con il percorso corretto se vuoi, questo è solo per renderlo più semplice). Fatto ciò, apri il prompt dei comandi in Windows o nel tuo terminale sul tuo Mac o Linux e vai alla cartella con il tuo file di input.

Per creare l'output direttamente nella finestra del terminale, utilizzare il seguente comando:

perl Markdown.pl input.txt

Quindi analizzerà il file di testo e produrrà il codice HTML valido sul terminale. Se si desidera che l'output venga indirizzato a un file HTML completamente separato, digitare il seguente comando: Advertising

perl Markdown.pl input.txt> output.html

Questo creerà il file HTML output.html in qualsiasi directory in cui ti trovi attualmente.

Avvolgendolo

Lasciatemi dire che se pensi che Markdown sia interessante e ne comprenda l'utilità, ti suggerisco caldamente che se scrivi qualcosa dovresti scriverlo con Markdow

n sintassi. È multipiattaforma, open source, gratuita e compatibile con tutto. Per me è un punto di svolta e mi sento un po 'indietro nel non utilizzarlo prima. Ancora una volta, c'è molto di più nella sintassi di quanto non abbia evidenziato qui, quindi dai un'occhiata a Daring Fireball per saperne di più.

A proposito, ho scritto questo intero articolo usando Markdown e se vuoi vedere la sintassi puoi scaricarla qui.