Chi utilizza Kate per scrivere documentazione, README, appunti o articoli in Markdown può ora contare su Katemark, un plugin progettato per visualizzare il risultato del documento direttamente accanto al testo. Il progetto si integra nell’editor di testo di KDE e permette di ottenere un’anteprima che richiama da vicino il rendering utilizzato da GitHub.
A differenza dei normali strumenti che aprono l’anteprima in una scheda separata, Katemark utilizza un pannello laterale posizionato accanto all’editor. Il contenuto viene aggiornato mentre si scrive e lo scorrimento dell’anteprima rimane sincronizzato con quello del documento.
Il plugin è un fork di Katdown e mantiene diverse delle funzionalità originali, aggiungendo però una serie di strumenti dedicati soprattutto a chi utilizza Markdown in modo intensivo.
Uno degli aspetti più interessanti è il funzionamento offline. Il renderer e gli elementi grafici necessari vengono forniti insieme al plugin, evitando richieste di rete durante il normale rendering. L’eccezione riguarda naturalmente le immagini provenienti dal web, quando l’utente sceglie di consentirne il caricamento.
È possibile scegliere tra due modalità grafiche principali: i colori utilizzati da GitHub, disponibili nelle varianti chiara e scura, oppure quelli derivati dal tema configurato in Kate.
Katemark supporta inoltre il front matter YAML, che viene rappresentato nell’anteprima sotto forma di tabella. Una modalità specifica chiamata “GitHub only” permette di limitare il rendering agli elementi che GitHub supporta effettivamente, rendendo più semplice controllare come apparirà un documento una volta pubblicato.
La compatibilità Markdown è particolarmente ampia. Oltre agli elementi tipici di GitHub, il plugin supporta estensioni markdown-it, sintassi utilizzate da CodiMD, Obsidian e MkDocs, oltre a formule matematiche e diagrammi.
Per le formule viene utilizzato KaTeX, con supporto alla sintassi inline e a quella su blocco. I diagrammi Mermaid possono invece essere inseriti attraverso i normali blocchi di codice dedicati.
Sincronizzazione, esportazione e strumenti per scrivere Markdown
Katemark non si limita alla visualizzazione. Il pannello di anteprima può essere aperto o nascosto tramite una scorciatoia da tastiera, il pulsante dedicato nella barra degli strumenti oppure attraverso il menu Tools di Kate.
La sincronizzazione dello scorrimento rappresenta una delle funzioni più utili durante la scrittura: spostandosi all’interno del documento, anche l’anteprima segue la stessa posizione e viceversa. Questo rende più semplice verificare immediatamente l’aspetto di una determinata sezione senza dover cercare manualmente il punto corrispondente.
Il plugin integra anche strumenti per l’esportazione. Il contenuto visualizzato può essere trasformato in un documento PDF oppure in un singolo file HTML autonomo. Quest’ultimo incorpora anche le immagini presenti sul computer e non necessita di script esterni per essere visualizzato.
Un’altra funzione interessante riguarda le immagini. Quando negli appunti è presente una fotografia e non è disponibile testo, Katemark può salvare automaticamente l’immagine nella cartella del documento Markdown. Il file viene inserito nel documento attraverso il relativo riferimento e il cursore viene posizionato nel punto appropriato per permettere di continuare rapidamente la scrittura.
Sono inoltre disponibili diverse azioni di formattazione direttamente dall’interfaccia, tra cui grassetto, corsivo, testo barrato, modifica del livello dei titoli, inserimento di collegamenti e formattazione delle tabelle.
Sul fronte della compatibilità, Katemark supporta elementi GitHub come tabelle, task list, alert, collegamenti, blocchi di codice evidenziati e front matter YAML. Le estensioni markdown-it aggiungono invece marcatura del testo, inserimenti, pedici, apici, note a piè di pagina ed emoji.
Per gli utenti Obsidian sono disponibili callout, wiki link, incorporamento delle immagini con dimensioni personalizzate e commenti. CodiMD aggiunge aree informative e sezioni richiudibili, mentre MkDocs permette di utilizzare le relative admonition.
La gestione dei collegamenti Obsidian è basata sulla cartella del documento, mentre non viene utilizzata una struttura a vault. Anche Mermaid dispone di funzioni aggiuntive, tra cui lo zoom tramite Ctrl e rotellina del mouse e il ripristino della dimensione originale con un doppio clic.
Come installare Katemark
Katemark richiede una versione di Kate basata su KDE Frameworks 6 e Qt 6.5 o superiore. Sono disponibili pacchetti per KDE neon e Kubuntu 26.04, mentre gli utenti Arch Linux possono utilizzare il pacchetto presente su AUR. Il progetto può inoltre essere compilato da sorgente su altre distribuzioni Linux.
Il plugin può essere attivato dalle impostazioni di Kate, nella sezione dedicata ai plugin. Una volta abilitato, è sufficiente aprire un documento Markdown e utilizzare la scorciatoia Ctrl+Shift+M per visualizzare l’anteprima laterale. Abbiamo testato l’estensione su Kubuntu 26.04 LTS (immagini articolo).
Con il supporto a GitHub Markdown, Obsidian, CodiMD, MkDocs, KaTeX e Mermaid, Katemark amplia sensibilmente le possibilità di Kate come ambiente per la scrittura tecnica. L’approccio locale e offline, unito alla sincronizzazione tra editor e anteprima, lo rende particolarmente interessante per chi vuole lavorare con Markdown direttamente dal desktop Linux senza dover ricorrere continuamente a strumenti basati sul browser.