Uso avanzato di MarkdownQuesta sezione espande quanto esposto come documentazione di base nel documento 'Migliorare i testi con Markdown' per dare a coloro che hanno particolari esigenze la possibilità di ottenere il massimo dal Markdown. Se il contenuto di questo documento non ti è chiaro o non ti è necessario puoi tranquillamente saltarne la lettura. Sono disponibili opzioni anche più avanzate. Vai alla sezione Ulteriori informazioni.
Ritorni a capoIn molti testi, ad esempio nelle poesie, è spesso necessario inserire dei ritorni a capo. Cercare di inserirli con tasto INVIO non darà l'effetto sperato perché le righe sono automaticamente attaccate l'una all'altra per formare un paragrafo.
Il testo precedente, ottenuto premendo INVIO alla fine di ogni riga, produce il seguente risultato, dove si nota come i ritorni a capo siano stati ignorati:
Inserendo alla fine di ogni riga due spazi, si forza un ritorno a capo:
Linee orizzontaliPer inserire linee orizzontali si devono utilizzare tre o più asterischi (*), trattini (-) o trattini di sottolineatura(_), con o senza spaziature. Tutti i seguenti testi producono il medesimo risultato:
che è: Immagini linkateIl testo introduttivo su Markdown dava informazioni su come creare web link e inserire immagini. Le due cose possono essere combinate per creare immagini che sono anche link cliccabili.
I due esempi sopra riportati mostrano un link e un'immagine. Posizionando l'immagine al posto del testo del link:
In qualsiasi punto del documento, si inseriranno le seguenti due righe, riportanti gli identificativi del link e dell'immagine:
Il risultato finale è la seguente immagine cliccabile, con relativo tooltip:
Un esempio di uso di questa tecnica è la visualizzazione di miniature (thumbnail) come link alle foto in formato più grande. Inserire codice HTMLSe la tua conoscenza di HTML è sufficiente, puoi inserire direttamente tag HTML, per avere un maggiore controllo sulla visualizzazione finale del testo.
Si noti come la sintassi HTML coesista con il codice Markdown per gli elenchi puntati. E' possibile quindi inserire un mix di comandi Markdown e HTML, in modo da combinare la semplicità del primo con la completezza del secondo. Visualizzare il codice HTML o testo preformattatoSe, a differenza di quanto esposto nella sezione precedente, si desidera che il codice HTML sia visualizzato esattamente come scritto e non processato dal browser, la riga deve iniziare con quattro spazi.
Si usa lo stesso sistema per visualizzare parti di programma:: Questa modalità è spesso usata per visualizzare programmi e altri testi che potrebbero contenere caratteri che Markdown usa come indicatori di diversi tipi di formattazione. La formattazione Markdown è pertanto abolita automaticamente in questo tipo di righe:: Per includere i caratteri speciali nel testo normale, vedi il paragrafo seguente. Usare i caratteri specialiPer usare i caratteri speciali che fanno parte della 'sintassi' di Markdown, si deve precederli da un carattere 'backslash' (\). Il backslash non sarà visualizzato ma il carattere seguente sarà mostrato così come inserito, senza dar luogo a un 'comando' per Markdown:
becomes * asterischi, non corsivo * piuttosto che
che produce corsivo, non asterischi Ulteriori informazioniIl sistema Markdown non è specifico di Moodle ma è usato in un numero crescente di strumenti di web publishing. Ulteriori informazioni su Markdown sono disponibili su http://daringfireball.net/projects/markdown/ |
