📄
← Torna alle guide

Come convertire Markdown in HTML: una guida completa

· Tag: markdown-to-html, markdown-converter, static-site-generator, jekyll-markdown, markdown-processing

Come convertire Markdown in HTML

Markdown è progettato per scrivere, ma il web funziona con HTML. Ogni documento Markdown deve essere convertito in HTML prima che un browser possa visualizzarlo. Questa guida copre i principali metodi per convertire Markdown in HTML.

Metodo 1: strumenti da riga di comando

Pandoc

Pandoc è il convertitore universale di documenti che supporta decine di formati.

# Conversione di base
pandoc input.md -o output.html

# HTML autonomo con tag <html> e <body>
pandoc input.md -o output.html -s

# Con sommario
pandoc input.md -o output.html -s --toc

Python-Markdown

pip install markdown
python -m markdown input.md > output.html

import markdown
with open("input.md", "r") as f:
    text = f.read()
html = markdown.markdown(text, extensions=["fenced_code", "tables"])

CommonMark (JavaScript)

npm install commonmark

const commonmark = require("commonmark");
const reader = new commonmark.Parser();
const writer = new commonmark.HtmlRenderer();
const parsed = reader.parse("# Hello\nThis is **bold**.");
const html = writer.render(parsed);

Metodo 2: generatori di siti statici

Jekyll

Jekyll alimenta GitHub Pages. Converte i file Markdown da _posts o dalle collection in HTML.

gem install jekyll bundler
jekyll new my-site
jekyll build
jekyll serve

Usa il processore Kramdown con i template Liquid per i contenuti dinamici.

Hugo

Hugo è un generatore di siti statici basato su Go, noto per velocità di build in millisecondi.

hugo new site my-site
hugo new posts/my-first-post.md
hugo server -D

Usa Goldmark come renderer Markdown predefinito con supporto per tabelle, blocchi di codice delimitati e note a piè di pagina.

Next.js (MDX)

Next.js supporta MDX, che consente di incorporare componenti React all'interno di Markdown.

npm install next @next/mdx @mdx-js/loader

MDX consente di includere esempi di codice interattivi, grafici e moduli nella documentazione.

Metodo 3: convertitore online

Per conversioni occasionali senza installare strumenti, i convertitori basati su browser forniscono risultati immediati:

  1. Incolla o digita Markdown nel pannello dell'editor.
  2. L'output HTML appare in tempo reale.
  3. Copia l'HTML generato per usarlo in qualsiasi pagina web o CMS.

Lo strumento di anteprima Markdown elabora GitHub Flavored Markdown — tabelle, blocchi di codice, elenchi di attività e barrato — interamente nel tuo browser.

Metodo 4: plugin per editor

| Editor | Funzionalità | Comando | |--------|---------|---------| | VS Code | Anteprima integrata | Ctrl+Shift+V | | Sublime Text | MarkdownPreview | Alt+M | | IntelliJ IDEA | Supporto integrato | Quick Documentation | | Vim | vim-markdown | :MarkdownPreview |

La pipeline di elaborazione

Quando un generatore di siti statici converte Markdown in HTML, segue questa pipeline:

Markdown → Parse to AST → Apply extensions → Render to HTML → Apply template → Output page

Se una funzionalità non viene renderizzata come previsto, il problema di solito è nel parser (non supporta la sintassi) o nel renderer (produce HTML inatteso).

Converti Markdown in HTML online

Usa lo strumento di anteprima Markdown per convertire Markdown in HTML all'istante. Digita o incolla Markdown nell'editor e l'anteprima renderizzata si aggiorna in tempo reale.

Come convertire Markdown in HTML: una guida completa - CoolTool