Markdown testo e layout del testo
Autore:[Antonio Gallonetto]
Markdown cos’è?
Markdown è un linguaggio di solo testo per descrivere il layout di un documento. Quindi abbiamo un file con solo testo contenuto, e delle regole per indicare come dovrà apparire il documento dopo essere stato convertito. La costruzione di un documento con il markdown è fatta di due fasi, costruzione del testo con degli indicatori su come dovrà apparire l’impaginazione e poi un software che andrà a generare il file finito correttamente impaginato. Le idee di markdown sono:
- sintassi semplicissima
- solo testo
- conversione facile
Le regole per scrivere un file markdown
Le regole per scrivere un file markdown sono le seguenti:
- Intestazione: sotto il testo scritto riportiamo
===
per tutta la lunghezza del testo - Sottointestazione: sotto il testo scritto riportiamo
--
per tutta la lunghezza del testo - Un altro modo di indicare le intestazioni è con
#
riportando un numero di cancelletto pari al livello di intestazione, quindi##
sarà una sottointestazione di#
- I paragrafi sono separati da una riga vuota.
- A capo a fine riga: due spazi bianchi alla fine di un testo indicano di andare a capo
- Grassetto:
**
i due asterischi prima e dopo la parola scritti in questo modo**prova**
- Corsivo: si indica con
*testo*
- Monospaziato: si indica con le virgolette
`testo`
- Un collegamento:
[test](https://www.velociraptus.com)
la parte tra parentesi quadre indica il testo che accompagna il link, nel caso ad esempio che non si usi un browser visuale e la parte tra parentesi il link vero e proprio - Inserimento di un’immagine
![Prova](prova.png)
- Lista si indica con
*
senza nessuna chiusura alla fine - Sottolista si indica con
*
rientrato - Note le note indicate a fondo pagina si indicano con
[^1]
in questo caso abbiamo la nota 1
Estensioni del markdown
Esistono moltissime estensioni di markdown che ampliano il linguaggio. Tutto questo per adattarlo meglio alle varie necessità.
Conversione da markdown a qualsiasi altra cosa.
Molto spesso gli editor di testo permettono di convertire direttamente il markdown in testo formattato, oppure si può usare un software come pandoc che ci permette di convertire il nostro documento in una quantità molto ampia di formati.
Editor di testo per markdown
- I vari editor di codice da Visual Studio Code a Atom supportano normalmente il markdown attraverso delle estensioni.
- vim
- Typora
- Editor markdown minimale
- Multipiattaforma
- Licenza proprietaria ma free
- Sito: Typora
- Haroopad
- Programma incentrato su due pannelli, quello di sinistra il testo scritto in markdown e a destra l’anteprima del testo
- Open Source
- Multipiattaforma
- Sito: Haroopad
- ReText
- Editor di testo per markdown e reStructuredText
- Open Source
- Multipiattaforma
- Sito: ReText
- WriteMonkey
- Software concentrato sul mantenere il Focus e quindi cerca di limitare il numero di distrazioni
- Licenza proprietaria free
- Windows
- Sito: WriteMonkey
Riferimenti
- JOHN GRUBER creatore di markdown
- Pandoc