Il Markdown è pensato come un modo per formattare il testo in modo facile da leggere e da scrivere. Alcuni dei nostri corsi hanno il markdown abilitato. La casella dei commenti apparirà così:
[Descrizione immagine: L'immagine sopra mostra una grande casella di commento con il testo 'Aggiungi un commento... (testo semplice e markdown disponibili)' all'interno. Sotto la casella c'è un conteggio dei caratteri che mostra 0/1200. Sopra la casella di commento c'è una bandiera arancione con le iniziali di Example Learner (EL) e accanto il nome completo di Example Learner]
Se il Markdown non è visualizzato correttamente, puoi cliccare sul pulsante Modifica in basso a destra del tuo commento e riprovare.
Contenuti
- Grassetto e Corsivo
- Paragrafi e interruzioni di riga
- Link
- Liste
- Citazioni
- Tabelle
- Intestazioni
- Codice
- Avanzato
Grassetto e Corsivo
Il testo racchiuso da un *asterisco* o _underscore_ sarà corsivo ;
Il testo racchiuso da due **asterischi** o __underscore__ sarà visualizzato in grassetto.
Se circondi un * o _ con spazi, sarà trattato come un asterisco o underscore.
Paragrafi e interruzioni di riga
Per separare il testo in paragrafi, premi invio due volte.
Questo crea un nuovo paragrafo proprio come faresti in un elaboratore di testi.
Quando vuoi inserire un'interruzione di riga, termina la frase con due spazi e premi invio. Questo crea un'interruzione di riga senza creare un nuovo paragrafo. È l'equivalente del tag <br /> in HTML.
Link
Dove il Markdown è supportato, gli URL non sono automaticamente linkati. Puoi rapidamente trasformare un URL in un link così:
<https://www.futurelearn.com>diventa:
Puoi anche trasformare un testo in un link mettendo il testo del link tra [parentesi quadre] subito seguito dall'URL tra parentesi tonde ( e ):
[Vai al sito di FutureLearn](https://www.futurelearn.com/)diventa:
Liste
Il Markdown supporta liste numerate e puntate.
Puoi usare asterischi (*), più (+) e trattini (-) in modo intercambiabile come punti elenco:
- Puoi usare asterischi…
- …più…
- …e trattini in modo intercambiabile come punti elenco. Assicurati di lasciare una linea vuota prima e dopo la lista.
- Dovrai inserire testo dopo la lista affinché venga visualizzata correttamente.
Le liste numerate usano numeri seguiti da un punto:
- Le liste ordinate usano numeri seguiti da un punto
- Ancora una volta, assicurati che la tua lista ordinata sia un paragrafo separato.
-
Se vuoi creare un elemento di lista con più paragrafi, premi invio due volte e rientra ogni paragrafo successivo con quattro spazi (o una tabulazione).
Ecco fatto! Hai un secondo paragrafo!
Citazioni
Le citazioni sono usate per mostrare citazioni ed estratti.
> Le citazioni si mostrano precedendo il testo con il simbolo maggiore di.diventa:
Puoi mettere paragrafi in una citazione inserendo una linea vuota che inizia con il simbolo maggiore di:
> Le citazioni si mostrano precedendo il testo con il simbolo maggiore di.
>
> Questo è un nuovo paragrafo
diventa:
Tabelle
Raccomandiamo tabelle con non più di due colonne perché vogliamo assicurarci che si visualizzino bene sui dispositivi mobili. Il seguente frammento:
| Intestazione Col1 | Intestazione Col2 |
| -------------| ------------|
| dato1 | dato3 |
| dato2 | dato4 |
| dato3 | dato5 |
creerà una tabella a due colonne con quattro righe, inclusa una riga di intestazione:
[Descrizione immagine: L'immagine sopra mostra il codice markdown sopra, reso sul sito come una tabella con due colonne e quattro righe]
Assicurati di lasciare una linea vuota prima e dopo la tabella.
Intestazioni
Usa uno o più caratteri cancelletto (#) all'inizio della riga. Tutte le intestazioni saranno presentate della stessa dimensione.
# Questa è un'intestazionediventa:
Codice
I blocchi di codice preformattati sono usati per scrivere riguardo alla programmazione o codice sorgente. Invece di formare paragrafi normali, le righe di un blocco di codice sono interpretate letteralmente.
All'interno di una riga normale
Puoi inserire codice in una riga racchiudendolo tra backtick (`).
Blocchi di codice
Ci sono diverse opzioni per scrivere un blocco di codice:
- rientra ogni riga del blocco di almeno 4 spazi o 1 tabulazione. Il blocco di codice continuerà fino a raggiungere una riga non rientrata, o la fine del tuo commento.
- con tre caratteri ~ (tilde) all'inizio e alla fine del blocco di codice.
La sintassi Markdown normale non viene processata all'interno dei blocchi di codice. Per esempio, *asterischi* sono solo asterischi letterali all'interno di un blocco di codice.
Evidenziazione della sintassi
Supportiamo l'evidenziazione della sintassi in oltre 70 linguaggi, inclusi Ruby, Python e Erlang. Per abilitare l'evidenziazione della sintassi su un blocco di codice usa il seguente formato:
~~~ nome linguaggio
# codice qui
~~~
Per esempio:
~~~ ruby
class Dog
def initialize(breed, name)
@breed = breed
@name = name
end
def bark
puts 'Ruff! Ruff!'
end
end
~~~
diventa:
Regole orizzontali
Puoi produrre una regola orizzontale posizionando tre o più trattini…
- - -…asterischi…
***…o underscore…
_ _ _…in una riga da soli, con una linea vuota prima e dopo.
Appaiono così:
Avanzato
Puoi fare l'escape della sintassi Markdown precedendo il carattere con una barra rovesciata:
\*asterischi letterali\*
Questo è supportato per:
\ backslash
` backtick
* asterisco
_ underscore
{ } parentesi graffe
[ ] parentesi quadre
( ) parentesi tonde
# cancelletto
+ segno più
- trattino
. punto
! punto esclamativo
< minore di
> maggiore di
Tag HTML
Supportiamo la scrittura diretta di un set limitato di tag HTML:
a pre code em strong br hr h1 h2 h3 h4 h5 h6 p ul ol li table tbody thead tfoot tr td th sub sup blockquote cite div
Il tag <a> supporta gli attributi href, title e id.
Qualsiasi altro tag o attributo non verrà visualizzato. Se devi scrivere HTML, consigliamo di metterlo all'interno di backtick singoli (`) o in un blocco di codice.
Apice e pedice
Puoi usare direttamente il tag HTML per testo in apice e pedice:
Questo è un testo con un po' di <sub>pedice</sub>
produrrà:
[Descrizione immagine: L'immagine sopra mostra solo testo che dice 'Questo è un testo con un po' di pedice' e la parola pedice è leggermente più piccola e posizionata più in basso rispetto al resto della frase]
e:
Questo è un testo con un po' di <sup>apice</sup>
produrrà:
[Descrizione immagine: L'immagine sopra mostra solo testo che dice 'Questo è un testo con un po' di apice' e la parola apice è leggermente più piccola e posizionata più in alto rispetto al resto della frase]
Simboli matematici
Supportiamo l'inserimento di matematica inline e come elementi a blocco. La matematica si scrive usando frammenti del linguaggio LaTex racchiusi da simboli `$$`. Questo viene reso nella pagina usando la libreria MathJax (https://www.mathjax.org/), che ha un'ottima documentazione sulla sua homepage. Maggiori dettagli su come usare i comandi TeX disponibili in MathJax si trovano nella pagina di Carol Fisher “TeX Commands Available in MathJax” (http://www.onemathematicalcat.org/MathJaxDocumentation/TeXSyntax.htm).
Puoi rendere la matematica racchiudendo la tua formula matematica tra doppi simboli di dollaro (`$$`).
Per mantenerla inline:
Possiamo rendere $$x$$, $$y$$ e $$\frac{x}{y}$$diventa:
[Descrizione immagine: L'immagine sopra mostra un commento che dice 'Possiamo rendere x, y e x su y']
Per mostrare matematica a blocco:
"Ecco un'equazione interessante:
$$
\frac{\partial^2\psi}{\partial x^2} = \frac{1}{c^2}\frac{\partial^2\psi}{\partial t^2}
$$
Che cos'è?"
diventa:
[Descrizione immagine: L'immagine sopra mostra un commento che dice 'Ecco un'equazione interessante:'. Sotto c'è la stessa formula sopra rappresentata come equazione matematica. Sotto ancora c'è il testo 'Che cos'è?']
Commenti
0 commenti
Questo articolo è chiuso ai commenti.