Perché ho creato MarkFlow: Il diario di uno sviluppatore
Ricordo ancora quel martedì sera. Erano le 23:00 e avevo appena finito la documentazione tecnica per la nostra nuova API.
Il contenuto era bellissimo: scritto in Markdown, con una struttura pulita, blocchi di codice perfetti e diagrammi Mermaid validi che spiegavano il flusso dei dati. Sentivo quella soddisfazione che ogni sviluppatore conosce quando il README.md è rifinito alla perfezione.
Poi, è apparsa una notifica Slack dal mio project manager:
“Ehi, ottimo lavoro sulla documentazione. Puoi inviarmela come documento Word? Il team legale deve rivederla con 'Revisioni' attivato, e non usano Markdown.”
Ho sospirato. “Certo, dammi cinque minuti.”
Famose ultime parole.
L'incubo dei “cinque minuti”
Ho aperto il mio terminale e ho eseguito un rapido comando Pandoc.
pandoc docs.md -o docs.docx
Ho aperto il risultato in Word. Il mio cuore è sprofondato.
- Le tabelle erano rotte. Le colonne erano schiacciate e le intestazioni disallineate.
- I diagrammi erano spariti. I miei bellissimi grafici Mermaid erano solo blocchi di codice nudi.
- L'evidenziazione della sintassi era svanita. Il codice Python sembrava testo semplice, difficile da leggere.
“Va bene”, ho pensato. “Proverò un convertitore online.”
Ho cercato su Google “Markdown to Word converter” e ho cliccato sul primo risultato. Mi ha chiesto di caricare il mio file. Mi sono fermato. Questo documento conteneva endpoint API interni e logica proprietaria. Non c'era modo che caricassi questo su un server casuale senza una chiara politica sulla privacy.
Così, ho fatto quello che farebbe qualsiasi sviluppatore disperato. Ho aperto Word su uno schermo, VS Code sull'altro, e ho iniziato a copiare e incollare.
Ho passato le successive due ore a rientrare manualmente gli elenchi, a fare screenshot dei miei diagrammi per incollarli come immagini e a riapplicare gli stili in grassetto. All'una di notte, ero esausto e frustrato. Non stavo programmando; stavo combattendo con un elaboratore di testi.
La realizzazione
Quella notte, ho capito due cose:
- Markdown è ottimo per scrivere, ma il mondo funziona su Word. Non possiamo sfuggirgli.
- Gli strumenti esistenti ti costringono a scegliere: o passare ore a configurare strumenti CLI come Pandoc, o sacrificare la tua privacy ai convertitori cloud.
Non volevo nessuno dei due. Volevo uno strumento che rispettasse la mia privacy (elaborazione locale) e rispettasse la mia formattazione (supporto GFM).
Così, ho creato MarkFlow.
Costruirlo per me stesso (e per te)
Ho iniziato a costruire MarkFlow come una piccola utilità per il mio uso personale. L'obiettivo era semplice:
- Deve essere locale. Voglio convertire contratti riservati o documentazione estesa senza che i dati lascino mai il mio browser.
- Deve gestire le cose “difficili”. Tabelle, elenchi di attività e, sì, evidenziazione della sintassi per i blocchi di codice.
- Deve essere veloce. Trascina, rilascia, fatto.
Quando ho mostrato la prima versione alla mia collega, i suoi occhi si sono illuminati. “Aspetta, mantiene la formattazione della tabella? E non devo installare Python?”
È stato allora che ho capito che questo non doveva rimanere solo uno script sul mio laptop.
Perché il “Local-First” è importante per me
Nel 2026, la privacy dei dati non è un lusso; è un requisito. Ho costruito MarkFlow con un'architettura unica in cui il motore di conversione viene eseguito direttamente nel tuo browser web.
Quando usi MarkFlow, non stai inviando il tuo file a me. Stai essenzialmente usando una potente app che si trova su un sito web. Ciò significa che puoi convertire i tuoi NDA, bozze di brevetti e diari privati senza alcuna paura di fughe di dati.
Dalla mia frustrazione alla tua produttività
Oggi, MarkFlow è cresciuto da quella frustrazione notturna a uno strumento robusto di cui si fidano migliaia di utenti.
- Niente più tabelle rotte.
- Niente più colori del codice mancanti.
- Niente più ansia per la privacy.
Ho costruito questo in modo che tu non debba mai passare il tuo martedì sera a combattere con la formattazione di Word. Concentrati sul contenuto; lascia che MarkFlow gestisca la presentazione.
Provalo con il tuo ultimo file .md. Spero che ti risparmi quelle due ore che io non recupererò mai.
— Lo Sviluppatore di MarkFlow
Trovi utile questo strumento? Aiutaci a diffonderlo.