Il cheatsheet di ribasso più completo online
Il cheatsheet di ribasso più completo online. Ogni elemento della sintassi con esempi, output renderizzato, compatibilità della piattaforma, errori comuni e suggerimenti degli esperti. Aggiungilo ai segnalibri.
Markdown è un modo semplice per formattare il testo utilizzando simboli come hashtag, asterischi e parentesi. È utile per scrittori, blogger, sviluppatori, studenti e chiunque crei contenuti online, perché rende la formattazione veloce, pulita e facile da riutilizzare su diverse piattaforme. Questo cheatsheet di Markdown ti mostrerà le regole più comuni in modo da poter scrivere e pubblicare in Markdown da ora in poi.
Cos'è il ribasso?
Markdown è un linguaggio di markup leggero che consente di utilizzare simboli di testo semplice per formattare i documenti. Quando digiti "bold" diventi grassetto. Quando digiti "# Intestazione" diventa un'intestazione. Quando usi Markdown, viene convertito in HTML. Funziona praticamente su ogni piattaforma ed è diventato il linguaggio predefinito per la formattazione su migliaia di strumenti, piattaforme e siti Web tra cui GitHub, Reddit, Discord, Notion, Slack e Obsidian.
Perché il ribasso è importante
John Gruber ha creato Markdown nel 2004 con l'obiettivo di consentire alle persone di scrivere e formattare documenti utilizzando testo semplice senza guardare un caos di tag. Oggi Markdown è diventato un linguaggio utilizzato praticamente da ogni sviluppatore e costruttore, nonché da autori di contenuti e altri.
I vantaggi del ribasso
Markdown è così popolare perché risolve molti problemi che si presentavano con i formati precedenti.
- Markdown funziona ovunque e funzionerà sempre: puoi aprire un file
.mdin qualsiasi editor di testo e su qualsiasi sistema operativo e sarai in grado di aprirlo tra 50 anni. - Puoi leggere Markdown senza renderizzarlo: A differenza di RTF o HTML, Markdown è un formato leggibile nella sua forma grezza, non solo dopo averlo renderizzato.
- Markdown è veloce da usare: Gli scrittori esperti possono formattare il testo mentre lo digitano e lavorare più velocemente.
- Markdown è universale: Come accennato in precedenza, molte piattaforme utilizzano Markdown in modo nativo.
Al giorno d'oggi, Markdown è importante sapere per chiunque crei qualcosa con strumenti di intelligenza artificiale, perché i LLM producono Markdown per impostazione predefinita.
Sintassi di base del markdown
Questi elementi provengono dalle specifiche originali del 2004 di John Gruber. Ogni parser di markdown li supporta, con piccole differenze di implementazione indicate di seguito.
Tabella di riferimento rapido
| Elemento | Sintassi Markdown |
|---|---|
| Intestazione ribasso | # H1 ## H2 ### H3 |
| Ribasso in grassetto | **grassetto** o __bold__ |
| Markdown corsivo | *corsivo* o _italico_ |
| Markdown Grassetto + Corsivo | ***grassetto corsivo*** |
| Markdown Blockquote | > testo citato |
| Elenco ordinato di ribasso | "1. Articolo` |
| Elenco non ordinato Markdown | - Elemento o * Elemento o + Elemento |
| Codice in linea di ribasso | `codice` |
| Blocco codice Markdown | Rientra 4 spazi o usa blocchi recintati |
| Regola orizzontale di markdown | --- oppure *** oppure ___ |
| Collegamento al ribasso | [testo](https://example.com) |
| Immagine ribassata |  |
| Interruzione riga di ribasso | Termina una riga con due spazi finali |
| Carattere di fuga Markdown | \*asterisco letterale\* |
Intestazioni di ribasso
Utilizza i simboli da 1 a 6 libbre (#) seguiti da uno spazio. Il numero di segni corrisponde al livello dell'intestazione HTML.
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
Sintassi alternativa (stile Setext) funziona solo per H1 e H2:
Heading 1
=========
Heading 2
---------
Best practice:
- Inserisci sempre uno spazio tra
#e il testo dell'intestazione. "#Heading" funziona in alcuni parser ma si interrompe in altri. - Utilizzare solo un H1 per documento (solitamente il titolo della pagina).
- Non saltare i livelli di intestazione. Vai H1 → H2 → H3, non H1 → H3.
- Aggiungi righe vuote prima e dopo le intestazioni per la massima compatibilità.
Markdown Grassetto, corsivo ed enfasi
**This is bold** and __this is also bold__
*This is italic* and _this is also italic_
***Bold and italic*** combined
Visualizza come:
Questo è in grassetto e anche questo è in grassetto Questo è corsivo e anche questo è corsivo Grasso e corsivo combinati
Capito: Alcuni parser non gestiscono i caratteri di sottolineatura nel mezzo di una parola. Per la massima compatibilità, utilizza gli asterischi per enfatizzare le parole centrali: un**believ**able, non un__believ__able.
Ribasso delle virgolette
Inizia qualsiasi riga con > per creare un markdown blockquote.
> This is a single-line blockquote.
> This is a blockquote
> that spans multiple lines.
> Blockquotes can be nested.
>
> > Like this.
>
> And they can contain **other markdown** elements.
Le virgolette Markdown funzionano bene per enfatizzare virgolette, callout e formattazione in stile risposta nelle e-mail.
Elenchi di ribasso
Elenchi non ordinati accettano -, * o + in modo intercambiabile. Scegli uno stile e mantienilo per coerenza.
- First item
- Second item
- Third item
- Nested item (indent two or four spaces)
- Another nested item
- Fourth item
Elenchi ordinati utilizzano numeri seguiti da un punto:
1. First item
2. Second item
3. Third item
Trucco utile: I numeri non devono essere corretti. Markdown si rinumera automaticamente:
1. First
1. Second
1. Third
...restituisce in modo identico a "1, 2, 3". Ciò significa che puoi riordinare gli articoli senza rinumerarli.
Elenchi di ribasso nidificati ordinati e non ordinati:
1. First step
2. Second step
- Sub-bullet
- Another sub-bullet
3. Third step
1. Sub-step
2. Another sub-step
Elenca elementi con più paragrafi: Rientra la continuazione dello stesso numero di spazi (solitamente 4 o una tabulazione):
1. First item
This paragraph belongs to the first item.
Notice the blank line above and the indent.
2. Second item
Link di ribasso
Link in linea sono lo stile più comune:
[Visit Google](https://www.google.com)
[With hover title](https://www.google.com "Google's homepage")
Link di markdown in stile riferimento sono utili quando lo stesso URL appare più volte o quando desideri mantenere la prosa pulita:
I love [Obsidian][1] and [VS Code][vscode] for markdown.
[1]: https://obsidian.md
[vscode]: https://code.visualstudio.com
URL automatici. Racchiudi un semplice URL tra parentesi angolari:
<https://example.com>
<hello@example.com>
Collegamenti relativi. Collegamento a file nello stesso repository o cartella:
[Read the license](./LICENSE.md)
[Parent directory file](../README.md)
Link di ancoraggio per il markdown. Passa a un'intestazione nella stessa pagina. La maggior parte dei parser genera automaticamente gli ID dal testo dell'intestazione (lettere minuscole, spazi fino ai trattini):
Jump to [the installation section](#installation).
## Installation
Riduci le immagini
La sintassi dell'immagine Markdown è la sintassi del collegamento con un punto esclamativo iniziale:


Immagini di markdown in stile riferimento funzionano allo stesso modo dei link di riferimento:
![Company logo][logo]
[logo]: /images/logo.png "Our logo"
Trasformare un'immagine di markdown in un collegamento:
[](https://example.com)
Ridimensionamento delle immagini. Il puro markdown non ha sintassi per questo. Utilizza l'HTML in linea come fallback:
<img src="image.jpg" alt="Alt text" width="400">
Nota sull'accessibilità: Scrivi sempre un testo alternativo significativo. Gli screen reader dipendono da esso e i motori di ricerca lo utilizzano per comprendere il contenuto delle immagini.  non è valido;  è buono.
Codice di ribasso
Codice in linea Markdown si avvolge in singoli backtick:
Install with `npm install markdown-it`.
Blocchi di codice Markdown. Rientra ogni riga di quattro spazi (o una tabulazione):
function hello() {
console.log("Hello, world!");
}
In pratica, quasi tutti utilizzano invece blocchi di codice recintati (trattati nella sezione sulla sintassi estesa di seguito) perché supportano l'evidenziazione della sintassi.
Escape dei backtick all'interno del codice in linea. Utilizza più backtick all'esterno:
To show a backtick, use `` `backtick` `` like this.
Regole orizzontali di ribasso
Tre o più trattini, asterischi o caratteri di sottolineatura su una riga separata:
---
***
___
Tutti e tre vengono visualizzati in modo identico. Metti righe vuote prima e dopo per compatibilità.
Interruzioni di riga del ribasso
Questa è una delle caratteristiche più confuse del markdown. Esistono tre comportamenti diversi:
Interruzione di paragrafo. Lascia una riga vuota tra il testo:
This is paragraph one.
This is paragraph two.
Interruzione di riga forzata (stesso paragrafo). Termina una riga con due spazi finali:
This line ends with two spaces.␣␣
This line is a break within the same paragraph.
Ripiego HTML. Utilizza <br> quando gli spazi finali sembrano troppo fragili:
This line has an HTML break.<br>
This is the next line.
Perché gli spazi finali sono controversi: Sono invisibili. La maggior parte degli editor li rimuove durante il salvataggio. GitHub Flavored Markdown (GFM) risolve questo problema trattando ogni singola riga come un'interruzione di riga all'interno di un paragrafo, ma CommonMark standard richiede gli spazi finali.
Caratteri Escape Markdown
Per visualizzare un carattere che markdown normalmente interpreterebbe come formattazione, precederlo con una barra rovesciata:
\*This shows literal asterisks\*
\# This shows a literal hash sign
\[not a link\]
Caratteri escapeable: \ ` * _ {} [] () # + - . ! |
Sintassi Markdown estesa
Questi elementi non sono nelle specifiche originali di Gruber, ma i processori di markdown più utilizzati li supportano, tra cui GitHub, GitLab, Reddit, Stack Overflow, Obsidian, Notion e Discord. La compatibilità varia, quindi controlla la matrice seguente prima di fare affidamento su qualcuno di essi.
Tabella di riferimento rapido
| Elemento | Sintassi Markdown |
|---|---|
| Tabella di ribasso | | Intestazione | Intestazione | + | ---| --- | |
| Blocco codice recintato Markdown | ```lingua ...``` |
| Evidenziazione della sintassi Markdown | Nome della lingua dopo l'apertura del recinto |
| Nota a piè di pagina Markdown | Ecco una nota.[^1] ... [^1]: Testo della nota. |
| ID intestazione ribassamento | ### La mia intestazione {#custom-id} |
| Elenco delle definizioni di markdown | termine newline : definizione |
| Markdown barrato | ~~testo cancellato~~ |
| Elenco attività Markdown | - [x] Fatto - [ ] Da fare |
| Codice breve Emoji Markdown | :gioia: :razzo: |
| Evidenziazione del ribasso | ==evidenziato== |
| Pedice Markdown | H~2~O |
| Apice Markdown | E = mc^2^ |
| URL automatico di markdown | <https://esempio.com> |
| Avvisi di riduzione di valore GitHub | > [!NOTA] > [!AVVERTIMENTO] > [!TIP] |
Tabelle di ribasso
Utilizza barre verticali (|) per le colonne e una riga di trattini per il separatore dell'intestazione.
| Name | Role | Location |
| -------- | ---------- | ------------- |
| Alice | Developer | Berlin |
| Bob | Designer | Montreal |
| Carol | Writer | Sydney |
Allineamento delle colonne. Aggiungi i due punti alla riga separatore:
| Left-aligned | Centered | Right-aligned |
| :----------- | :----------: | ------------: |
| apples | bananas | $100 |
| cherries | dates | $12 |
Suggerimenti che mancano alla maggior parte delle guide:
- Non è necessario allineare i tubi nella sorgente. Il renderer gestisce la spaziatura.
- I tubi esterni sono facoltativi, ma aggiungerli aiuta con la leggibilità e i plugin dell'editor.
- È possibile utilizzare il markdown di base all'interno delle celle (
**bold**,*italic*,`code`, collegamenti). - Non è possibile utilizzare elementi di blocco (intestazioni, virgolette, elenchi) all'interno delle celle.
- Per contenuti su più righe all'interno di una cella, utilizzare "
" invece di un'interruzione di riga. - Per visualizzare un carattere pipe letterale all'interno di una cella, utilizzare l'entità HTML
|.
Blocchi di codice delimitati da markdown
Tre backtick (o tilde) aprono e chiudono un blocco. Aggiungi un identificatore di lingua dopo la recinzione di apertura per l'evidenziazione della sintassi:
```pitone
def saluto(nome):
return f"Ciao, {nome}!"
print(saluto("mondo"))```
Identificatori di linguaggio comuni: python, javascript, typescript, bash, shell, sql, json, yaml, html, css, rust, go, java, c, cpp, csharp, php, ruby, swift, kotlin, dart, r, scala, diff.
Mostra modifiche al codice con diff:
```diff
- const old = "rimuovi questo";
+ const new = "aggiungi questo";```
Escape tripli backtick. Avvolgi il blocco in quattro backtick:
````
Questo blocco contiene```triple backticks```dentro.````
Note sul ribasso
Le note a piè di pagina Markdown sono perfette per citazioni, digressioni e note esplicative senza ingombrare la tua prosa.
Here is a statement that needs a source.[^1]
Here is another claim.[^detailed-note]
[^1]: This is a short footnote.
[^detailed-note]: Named footnotes still render as numbers, but they're
easier to track in the source. They can span multiple lines if you
indent the continuation.
ID intestazioni ribassate
Alcuni parser ti consentono di assegnare ID personalizzati alle intestazioni per un collegamento di ancoraggio preciso:
### My Great Heading {#custom-heading-id}
Jump to [my heading](#custom-heading-id).
GitHub e molti altri generano automaticamente gli ID dal testo dell'intestazione, quindi di solito non ne hai bisogno.
Elenchi di definizioni di ribasso
Markdown
: A lightweight markup language for formatting plain text.
HTML
: The standard markup language for web pages.
CSS
: The language used to style HTML documents.
Il supporto è discontinuo. Funziona con Pandoc, PHP Markdown Extra e pochi altri, ma non con GFM standard.
Ribasso barrato
Avvolgi il testo in due tilde per cancellarlo:
~~This text is struck through.~~
Restituisce come: Questo testo è barrato.
Funziona con GFM, Reddit, Discord, Slack e i processori più diffusi. Non nel CommonMark standard.
Elenchi attività di markdown
Caselle di controllo interattive, comunemente utilizzate nei problemi di GitHub, nelle richieste pull e nelle schede di progetto:
- [x] Write the first draft
- [x] Edit for clarity
- [ ] Publish the article
- [ ] Promote on social media
- [ ] Twitter
- [ ] LinkedIn
- [ ] Hacker News
Su GitHub, queste vengono visualizzate come caselle di controllo selezionabili che puoi attivare direttamente nell'interfaccia utente.
Emoji ribasso
La maggior parte delle piattaforme supporta gli shortcode emoji:
Ship it :rocket: and celebrate :tada::champagne:
Puoi anche incollare direttamente i caratteri emoji reali. Rendono bene in qualsiasi file markdown poiché sono solo Unicode. 🚀🎉
Evidenziazione del markdown, pedice, apice
I need to ==highlight== this important idea.
Water is H~2~O.
Einstein's famous equation: E = mc^2^.
Il supporto è limitato. Funziona con Obsidian, MultiMarkdown e alcuni parser estesi, ma non con GFM.
Collegamento URL automatico Markdown
Racchiudi un URL tra parentesi angolari per creare un collegamento automatico:
<https://example.com>
<contact@example.com>
In GitHub Flavored Markdown, qualsiasi URL semplice viene convertito automaticamente. Non hai nemmeno bisogno delle parentesi.
Matrice di compatibilità della piattaforma
Utilizza questa tabella per verificare quali elementi di sintassi funzionano sulle piattaforme che utilizzi. "Sì" significa supporto completo, "No" significa nessun supporto e "Parziale" significa che la funzionalità funziona con limitazioni o utilizza una sintassi non standard.
| Caratteristica | GFM | GitLab | Discordia | Allentato | Nozione | Ossidiana | Overflow dello stack | |
|---|---|---|---|---|---|---|---|---|
| Intestazioni | Sì | Sì | Sì | No | No | Sì | Sì | Sì |
| Grassetto/Corsivo | Sì | Sì | Sì | Sì | Parziale* | Sì | Sì | Sì |
| Barrato | Sì | Sì | Sì | Sì | Sì | Sì | Sì | Sì |
| Citazione | Sì | Sì | Sì | Sì | Sì | Sì | Sì | Sì |
| Elenchi | Sì | Sì | Sì | Sì | Sì | Sì | Sì | Sì |
| Codice in linea | Sì | Sì | Sì | Sì | Sì | Sì | Sì | Sì |
| Codice recintato | Sì | Sì | Sì | Sì | Sì | Sì | Sì | Sì |
| Evidenziazione della sintassi | Sì | Sì | Parziale | Parziale | No | Sì | Sì | Sì |
| Collegamenti | Sì | Sì | Sì | Sì | Parziale** | Sì | Sì | Sì |
| Immagini | Sì | Sì | Parziale | Parziale | Parziale | Sì | Sì | Sì |
| Tabelle | Sì | Sì | Sì | No | No | Sì | Sì | Sì |
| Elenchi attività | Sì | Sì | No | No | No | Sì | Sì | No |
| Note a piè di pagina | Sì | Sì | No | No | No | No | Sì | No |
| Codici brevi Emoji | Sì | Sì | No | Sì | Sì | No | Parziale | No |
| Matematica (LaTeX) | Sì | Sì | No | No | No | Sì | Sì | Sì |
| Diagrammi della sirena | Sì | Sì | No | No | No | No | Sì | No |
| Sottolineato | No | No | No | Sì | No | Sì | Parziale | No |
| Testo spoiler | No | No | Sì | Sì | No | No | No | No |
* Slack utilizza asterischi singoli per il grassetto (non doppi) e trattini bassi singoli per il corsivo.
** Slack utilizza la sintassi <url|text> invece dei collegamenti markdown standard.
Ribasso aromatizzato su GitHub
GitHub Flavored Markdown (GFM) è il dialetto di markdown più influente. Poiché GitHub è la sede predefinita per i progetti open source, le convenzioni GFM sono diventate lo standard de facto.
GFM aggiunge quanto segue oltre al ribasso standard:
Avvisi GitHub
Una speciale sintassi delle virgolette per i callout. Sono supportati cinque tipi:
> [!NOTE]
> Useful information that users should know.
> [!TIP]
> Helpful advice for doing things better.
> [!IMPORTANT]
> Key information users need to know.
> [!WARNING]
> Urgent info needing immediate attention.
> [!CAUTION]
> Advises about risks or negative outcomes.
Ciascuno viene visualizzato con un colore e un'icona distinti su GitHub.
Riferimenti con collegamento automatico Markdown
All'interno dei repository GitHub, alcuni modelli diventano automaticamente collegamenti:
#123→ collegamenti al problema o alla richiesta pull n. 123@nomeutente→ menziona un utenteorg/repo#123→ collega a un problema in un altro repositorya1b2c3d→ collega a un hash di commit
Diagrammi della sirena Markdown
I blocchi di codice recintati con "sirena" come linguaggio vengono visualizzati come diagrammi di flusso, diagrammi di sequenza e altro:
```sirena
grafico LR
A[Inizio] --> B{Decisione}
B -->|Sì| C[Fai la cosa]
B -->|No| D[Saltalo]```
Espressioni matematiche Markdown
GFM supporta la matematica LaTeX in due forme:
Inline math: $E = mc^2$
Block math:
$$
\frac{n!}{k!(n-k)!} = \binom{n}{k}
$$
Ribasso specifico della piattaforma
Ribasso della discordia
Discord utilizza la propria variante di ribasso. Principali differenze rispetto allo standard:
__underline__(doppio carattere di sottolineatura) produce sottolineato, non grassetto- "grassetto" funziona ancora
*italic*e_italic_funzionano entrambi||spoiler||nasconde il testo finché non viene cliccato- "# Intestazione" funziona, ma sono supportati solo H1, H2 e H3
- I blocchi di codice e il codice in linea funzionano normalmente
- Nessuna tabella, nessuna immagine tramite la sintassi di markdown
Slack Markdown (mrkdwn)
Il sapore di ribasso di Slack, chiamato confusamente "mrkdwn", diverge in modo significativo:
- "grassetto" utilizza asterischi singoli (non doppi)
_italic_utilizza singoli caratteri di sottolineatura~barrato~utilizza singole tilde`codice`funziona normalmente> quotefunziona normalmente- I collegamenti utilizzano la sintassi "<https://example.com|testo collegamento>".
- Nessuna intestazione, nessuna tabella, nessun elenco di attività
Se incolli il markdown standard in Slack, non verrà formattato correttamente. Converti prima.
Ribasso su Reddit
Reddit supporta la maggior parte della sintassi standard ed estesa con alcune peculiarità:
>!spoiler!<per il testo spoiler^apicecon un accento circonflesso (non è necessario l'accento circonflesso di chiusura per le singole parole)- Supporta tabelle, barrato e blocchi di codice
- Non supporta elenchi di attività, note a piè di pagina o ID di intestazioni personalizzate
Ribasso delle nozioni
Notion supporta l'input di markdown ma lo converte nel suo sistema a blocchi. Puoi digitare markdown per creare rapidamente blocchi:
- Il ribasso standard funziona durante l'input
- Notion aggiunge le proprie funzionalità (database, interruttori, callout) che non sono riduzioni di prezzo standard
- Incollare il contenuto del ribasso generalmente viene importato in modo pulito
Ribasso sull'ossidiana
Obsidian è un'app per prendere appunti che utilizza il markdown, con diverse estensioni:
- "[[Link in stile Wiki]]" per i collegamenti interni tra le note
[[Nota#intestazione]]per collegarsi a un'intestazione specifica in un'altra nota![[Nota]]per incorporare il contenuto di un'altra nota> [!note] Titolo del calloutper i callout di Obsidian (simile agli avvisi di GitHub)- Supporto completo per la matematica LaTeX
- Supporto completo per la sirena
Errori comuni nel ribasso
Anche gli scrittori esperti commettono questi errori di ribasso. Ecco cosa evitare e come.
1. Righe vuote mancanti attorno agli elementi del blocco markdown
Elenchi, intestazioni, blocchi di codice e virgolette di solito necessitano di una riga vuota prima e dopo. Senza di esso, alcuni parser li uniscono nel paragrafo circostante.
Sbagliato:```markdown Here is a paragraph.
Heading
More text.
**Giusto:**```markdown
Here is a paragraph.
## Heading
More text.
2. Rientro dell'elenco dei ribassi incoerente
Gli elenchi nidificati necessitano di un rientro coerente. La combinazione di rientri a due e quattro spazi o la combinazione di tabulazioni e spazi produce risultati imprevedibili. Scegline uno e mantienilo.
3. Dimenticare gli spazi finali per le interruzioni di riga del ribasso
Se desideri un'interruzione di riga all'interno di un paragrafo ma il testo scorre insieme, probabilmente hai dimenticato i due spazi finali. Questa è la domanda di ribasso più comune su Stack Overflow.
4. Percorsi relativi delle immagini di markdown che si interrompono dopo la distribuzione
 funziona nel tuo editor ma si interrompe quando viene distribuito in una sottodirectory. Utilizza percorsi assoluti del sito (/images/logo.png) o URL completi per la portabilità.
5. Utilizzo di virgolette inglesi in stile Word nei blocchi di codice markdown
Quando incolli il codice da un documento che contiene virgolette inglesi (" invece di "), il codice non funzionerà una volta copiato. Incolla sempre il codice come testo normale nei file markdown.
6. Mescolare HTML e markdown all'interno dello stesso blocco
Il markdown all'interno dei tag HTML a livello di blocco spesso non viene visualizzato. Questo fallisce:
<div>
**This bold won't render.**
</div>
Risolvilo separandoli con righe vuote o utilizzando solo HTML incorporato:
<div>
**This bold will render.**
</div>
7. Saltare i livelli di intestazione del ribasso
Passare direttamente da H1 a H3 abbassa il livello di accessibilità e danneggia la SEO. Utilizza i livelli di intestazione in sequenza.
8. Utilizzo dei caratteri di sottolineatura all'interno delle parole nel markdown
un_believ_able produce corsivo in alcuni parser e caratteri di sottolineatura letterali in altri. Utilizza gli asterischi per enfatizzare la parola centrale: "unbelievable".
Domande frequenti su Markdown
A cosa serve il ribasso?
Markdown viene utilizzato per la documentazione (README, documenti API, wiki), post di blog, scrittura tecnica, prendere appunti, messaggi di chat su piattaforme come Discord e Slack, siti Web statici, e-book e ovunque sia utile la formattazione di testo semplice. La maggior parte dei modelli linguistici di grandi dimensioni genera risposte in markdown per impostazione predefinita.
Il ribasso è lo stesso su ogni piattaforma?
No. La sintassi di base (titoli, enfasi, elenchi, collegamenti, codice, virgolette) funziona quasi ovunque, ma le funzionalità estese come tabelle, note a piè di pagina, elenchi di attività e calcoli variano in modo significativo tra le piattaforme. Per ulteriori informazioni, vedere la matrice di compatibilità sopra.
Quale estensione di file utilizza Markdown?
".md" è il più comune. Potresti anche vedere .markdown, .mdown, .mkd o .mkdn. Hanno tutti lo stesso formato. Il tipo MIME è "text/markdown", registrato in RFC 7763.
Posso utilizzare l'HTML all'interno del markdown?
SÌ. Quasi tutti i processori di markdown trasmettono HTML grezzo all'output. Questo è il modo in cui le persone aggiungono funzionalità che il markdown non supporta in modo nativo, come i tag "" per i tasti della tastiera, "
Come posso convertire Markdown in PDF, Word o HTML?
In HTML: Ogni processore di markdown lo fa in modo nativo. Pandoc, markdown-it emarked sono librerie popolari.
In PDF: utilizza Pandoc (pandoc input.md -o output.pdf), la funzione di esportazione di Typora o VS Code con l'estensione Markdown PDF.
In Word (.docx): Pandoc gestisce questo in modo pulito con pandoc input.md -o output.docx.
Markdown supporta le equazioni matematiche?
Non nelle specifiche originali, ma molti processori (GitHub, GitLab, Obsidian, MkDocs, Jupyter, Notion) supportano la matematica LaTeX. Utilizza $...$ per la matematica in linea e $$...$$ per le equazioni a blocchi.
In cosa differisce il markdown dall'HTML?
L'HTML utilizza tag (<p>, <strong>, <a>) che sono dettagliati ma precisi. Markdown utilizza simboli di punteggiatura che sono veloci da digitare e rimangono leggibili in formato testo normale. Ogni file di markdown viene infine convertito in HTML per la visualizzazione. Markdown è un superset di HTML. Puoi sempre rilasciare HTML in un file Markdown quando hai bisogno di qualcosa che Markdown non può esprimere.
Cos'è CommonMark?
CommonMark è una specifica standardizzata per il ribasso, pubblicata nel 2014 per risolvere le ambiguità nelle specifiche originali di Gruber. La maggior parte dei processori implementa CommonMark come base, quindi aggiunge sopra le estensioni (tabelle, elenchi di attività, ecc.). GitHub Flavored Markdown è CommonMark più le estensioni di GitHub.
Il ribasso è gratuito?
SÌ. Markdown non è un software. È una specifica. Sia la specifica Gruber originale che la specifica CommonMark sono disponibili gratuitamente. Il nome "Markdown" in sé non è un marchio registrato.
Quanto tempo ci vuole per imparare il markdown?
Le nozioni di base (titoli, grassetto, corsivo, collegamenti, elenchi) richiedono circa cinque minuti. Puoi scrivere un utile ribasso entro un'ora. Padroneggiare la sintassi estesa e le variazioni specifiche della piattaforma richiede più tempo, ma questo cheatsheet copre quasi tutto ciò di cui avrai bisogno.
Qual è la differenza tra markdown e rich text?
I formati rich text (.docx, .rtf) memorizzano la formattazione come dati binari o XML insieme al testo. Markdown memorizza la formattazione come simboli di testo semplice visibili. Il compromesso: il rich text ti offre un controllo perfetto al pixel a scapito della portabilità; il markdown ti offre portabilità e velocità a scapito di un controllo capillare.