Formattazione del testo con Markdown

markdown
questo il periodo dell’anno che dedico parte del tempo al pensiero creativo in cui cerco strategie diverse per migliorare il mio lavoro.
Ho deciso di riprendere la tradizione incominciata qualche tempo fa di scrivere gli articoli non solo per i miei studenti, ma anche per me 🙂 in modo che possa conservare in maniera ordinata informazioni che posso riprendere per la mia formazione e organizzazione.

Nella lunghissima lista dei ToDo trovo la nota: “imparare ad usare il Markdown per velocizzare la scrittura di documenti su internet“.

Procedo… seduto all’ombra di un albero con l’iPad sulle gambe.

Estraggo l’elemento dal ToDo e ne costruisco una mappa mentale che mi consente di progettare e pensare a “a ruota libera“.

Ma cos’ il Markdown?

Tutto nasce dall’esigenza di poter scrivere in ogni luogo con qualsiasi strumento, in modo rapido, senza vincoli tecnologici legati allo strumetto hardware o software, in breve concentrarsi sul contenuto.

Markdown un linguaggio di markup creato da John Gruber e Aaron Swartz che consente a blogger e scrittori di ogni tipo di scrivere testi in maniera veloce utilizzando una sintassi estremamente semplice ed efficace permettendo poi di convertire i testi in (X)HTML immediatamente fruibile senza la paura di dimenticare la chiusura di tag HTML o fare errori di scrittura di tag.

Se questo motivo non vi bastano vi rimando alla brillante e rapidissima spiegazione di Brett Terpstra che con il suo articolo: “Why Markdown? A two-minute explanation” ci illustra i suoi motivi, che condivido pienamente:

  • semplice;
  • veloce;
  • pulito;
  • mobile;
  • flessibile;
  • si adatta ad ogni flusso di lavoro.

Ma come imparare ad usare Markdown?

Basta andare alla fonte, sul blog Daring Fireball (di John Gruber), troverete le basi per imparare in 10 minuti tutto e nella sezione Syntax la sintassi completa.

Come ho scritto questo post? Usando la notazione Markdown 🙂

Di seguito il tutorial tratto dal sito Daring Fireball.

Tutorial

Markdown:

Risultato:

Enfatizzare

Markdown usa asterischi e sottolineato per enfatizzare il testo

Markdown:

Risultato:

Liste

Per realizzare le liste non ordinate (liste puntate) usa asterischi, segno + o trattino (*, + e -) come marker. Questi tre simboli sono interscambiabili:

Oppure:

Oppure:

Tutti producono lo stesso risultato:

Le liste ordinate (ordinate) usano come marker numeri seguiti da un punto:

Risultato:

Se inserite righe vuote tra gli elementi inserirete un paragrafo <p> tra gli elementi. E’ possibile creare un lista di paragrafi identando con 4 spazio oppure un tab ogni singolo elemento della lista

Risultato:

Markdown supporta due stili per la creazione di link: inline e reference. Con entrambi gli stili, possibile utilizzare le parentesi quadre per delimitare il testo che si desidera trasformare in un link.

Lo stile inline dei link usa le parentesi immediatamente dopo il testo del link.

Esempio:

Risultato:

Opzionalmente, potete includere l’attributo title tra le parentesi tonde dopo il link:

Risultato:

Lo stile reference dei link consente di fare riferimento al link con dei nomi definiti in un altro punto del documento:

Risultato:

L’attributo “title” facoltativo. I nomi dei collegamenti possono contenere lettere, numeri e spazi, ma non sono case sensitive:

Risultato:

Immagini

La sintassi per le immagini molto simile a quella dei link.

Inline (i titoli sono opzionali):

Reference-style:

Entrambi gli esempi di cui sopra producono lo stesso output:

CODE

In un paragrafo normale, possibile creare una sezione codice includendo il testo tra virgolette inverse. E commerciali (&) e le parentesi angolari (<o>) saranno automaticamente tradotte in entit HTML. Ci facilita la scrittura di codice HTML in Markdown ad esempio:

Risultato:

Per specificare un intero blocco di codice pre-formattato, rientrate per ogni riga di 4 spazi o 1 tab.

Markdown:

Risultato:

Cosa uso?

 

Articoli simili:

Questa voce è stata pubblicata in tutorial e contrassegnata con , , , , , . Contrassegna il permalink.

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *

Questo sito usa Akismet per ridurre lo spam. Scopri come i tuoi dati vengono elaborati.