Cos'è Markdown? Una spiegazione completa del linguaggio di markup leggero
Risposta rapida
Markdown è un linguaggio di markup di testo semplice che utilizza simboli semplici per formattare il testo: # per i titoli, ** per il grassetto, * per il corsivo, - per gli elenchi, [testo](url) per i collegamenti. È progettato per essere leggibile come testo semplice e convertibile in HTML. Utilizza il nostro convertitore gratuito da Markdown a HTML per eseguire il rendering di Markdown nel tuo browser.
Introduzione
Markdown è un linguaggio di markup leggero creato da John Gruber nel 2004 che utilizza la formattazione del testo semplice per produrre documenti strutturati. L'obiettivo è la leggibilità: il testo sorgente di Markdown dovrebbe avere l'aspetto che rappresenta, senza l'ingombro visivo dei tag HTML. Markdown è lo standard per i file README su GitHub, siti di documentazione, post di blog, commenti su piattaforme come Reddit e Stack Overflow e app per prendere appunti come Obsidian e Notion. Markdown viene convertito in HTML per la pubblicazione sul Web.
Passo dopo passo
-
Impara la sintassi di base
Intestazioni: # H1, ## H2, ### H3. Grassetto: **testo**. Corsivo: *testo*. Elenchi: - articolo o 1. articolo. Collegamenti: [testo](url). Immagini: . Codice: ``inline` o ```block```. Blockquotes: > citazione. Regola orizzontale: ---.
-
Comprendi la filosofia
Markdown è progettato per essere leggibile come testo semplice. La fonte dovrebbe assomigliare all'output finale renderizzato: **bold** sembra grassetto, # Heading sembra un'intestazione. Ciò contrasta con HTML, dove <strong>grassetto</strong> e <h1>intestazione</h1> sono visivamente disordinati.
-
Impara le varianti
Il markdown originale (specifiche di Gruber) è minimo. CommonMark è una versione standardizzata e ben specificata. GitHub Flavored Markdown (GFM) aggiunge tabelle, barre barrate, elenchi di attività e collegamenti automatici. MDX ti consente di incorporare componenti React in Markdown. La maggior parte degli strumenti supporta GFM.
-
Converti Markdown in HTML
Markdown viene convertito in HTML per la pubblicazione sul Web. # Ciao diventa <h1>Ciao</h1>, **grassetto** diventa <strong>grassetto</strong>. I generatori di siti statici (Astro, Hugo, Jekyll) convertono Markdown in fase di creazione. Utilizza il nostro convertitore Markdown to HTML per una conversione istantanea.
Esempi
Titolo e paragrafo
Ingresso: # Titolo
Un paragrafo.
Produzione: <h1>Title</h1>
<p>A paragraph.</p>
Grassetto e corsivo
Ingresso: **grassetto** e *corsivo*
Produzione: <strong>bold</strong> and <em>italic</em>
Collegamento e immagine
Ingresso: [text](https://example.com) and 
Produzione: <a href="https://example.com">text</a> and <img src="image.png" alt="alt">
Problemi comuni
- Interruzioni di riga: un singolo ritorno a capo in Markdown non crea un'interruzione di riga in HTML. Utilizza due spazi alla fine di una riga o due ritorni a capo per un'interruzione di paragrafo.
- Elenchi nidificati: il rientro è importante. Utilizza 2 o 4 spazi in modo coerente per gli elementi nidificati; mescolarli può rompere la struttura dell'elenco.
- Raw HTML: la maggior parte dei parser Markdown passa attraverso il raw HTML, ma alcuni lo disinfettano. Controlla il comportamento del tuo parser se incorpori HTML direttamente.
- Gusti diversi: Original Markdown, CommonMark e GFM presentano sottili differenze. Controlla quale sapore supporta la tua piattaforma di destinazione.
Suggerimenti
- Utilizza Markdown per scrivere e documentare: è molto più semplice da leggere e scrivere rispetto a HTML.
- GitHub Flavored Markdown (GFM) è la variante più comune: aggiunge tabelle, barre barrate ed elenchi di attività.
- Scrivi in Markdown e converti in HTML in fase di creazione per blog e siti di documentazione.
- Utilizza il nostro convertitore da Markdown a HTML per eseguire il rendering immediato di Markdown nel tuo browser.