Siamo felici di annunciare il rilascio della nuova major version della nostra suite di strumenti open source per il formato Markdown: un nuovo motore di conversione, un nuovo modo di visualizzare i documenti (con pieno supporto a mermaid, formule matematiche e grafici) e tanta documentazione nuova. ✨
⚙️ Markdown Processor 2.0: un motore tutto nuovo
Il cuore della suite è stato riscritto da zero seguendo la strategia di parsing della specifica CommonMark:
- ✅ CommonMark 0.31.2: superati tutti i 652 esempi della specifica
- ✅ GitHub Flavored Markdown 0.29: superati tutti i 24 esempi (tabelle, task list, barrato, link automatici)
- 🐙 Nuovo dialetto predefinito GitHub, che rende i documenti come github.com: GFM più formule matematiche, alert e diagrammi mermaid
- ➗ Formule matematiche (
$...$e$$...$$) per KaTeX, oppure come immagini per i viewer senza JavaScript - 💡 Alert di GitHub (
[!NOTE],[!TIP],[!WARNING]…) - 🧩 Estensioni opzionali: pedice, apice, testo inserito ed evidenziato, tipografia “smart”, id dei titoli, wiki link
- 🌳 Albero sintattico in sola lettura (
IMarkdownNode) per chi vuole analizzare il documento - 📦 Nuovo componente non visuale TMarkdownToHTML, per VCL e FMX
- 🛠️ Setup che riconosce le versioni di Delphi installate (da XE6 a 13 Florence), compila e installa i package e aggiunge i percorsi
- 💻 Utility a riga di comando MarkDownToHTML.exe aggiornata
I dialetti storici DaringFireball e TxtMark restano disponibili e producono lo stesso output di prima.
🔍 Markdown Help Viewer 3.0: il viewer passa a WebView2
- 🌐 I documenti sono mostrati con Microsoft Edge WebView2: formule con KaTeX, diagrammi mermaid, alert e CSS moderno, proprio come su GitHub
- 📊 Anche i grafici: torta, barre, linee, quadranti, sankey, radar e treemap, scritti come testo dentro il documento
- ✈️ Funziona anche senza connessione Internet: KaTeX e mermaid sono installati insieme al viewer
- 🔄 Se WebView2 non è disponibile, il viewer torna automaticamente al visualizzatore HTML interno
- 🧱 Per gli sviluppatori Delphi c’è il nuovo componente TEdgeMarkdownViewer (Delphi 12 e 13), con le stesse proprietà di TMarkdownViewer, che resta disponibile per le versioni precedenti
- 🎨 Tema chiaro e scuro, esportazione in PDF e in HTML
🎨 Markdown Editor e Shell Extensions 3.0
- ✍️ L’anteprima dell’editor usa WebView2: quello che scrivi lo vedi subito, con formule, diagrammi e grafici
- 🔗 Scorrimento sincronizzato tra testo e anteprima
- 🖍️ Evidenziazione della sintassi dei blocchi di codice in base al linguaggio, come su GitHub
- 📄 Esportazione in HTML (pagina completa) e in PDF
- 🗂️ Le Shell Extensions mostrano l’anteprima dei file Markdown direttamente nel pannello di anteprima di Esplora risorse
📚 Documentazione rinnovata
Il sito della documentazione è stato aggiornato in ogni parte, con due nuove pagine dedicate ai diagrammi Mermaid e ai grafici, piene di esempi pronti da copiare. 👉 ethea.it/docs/markdowntools
⚠️ Per chi aggiorna
Il dialetto predefinito ora è GitHub. Le impostazioni salvate dalle versioni precedenti vengono convertite automaticamente. Chi usa la libreria nel proprio codice trova le istruzioni nella guida Migrating to the new engine.
⬇️ Download
Tutti gli strumenti sono gratuiti e open source (licenza Apache 2.0) e hanno un Setup pronto all’uso:
Buon Markdown a tutti! 🎉 E se trovate un problema o avete un’idea, apriteci pure una issue su GitHub. 🙏