Pourquoi j'ai créé MarkFlow : Le journal d'un développeur

Je me souviens encore de ce mardi soir. Il était 23 heures et je venais de terminer la documentation technique de notre nouvelle API.

Le contenu était magnifique — écrit en Markdown, avec une structure claire, des blocs de code parfaits et des diagrammes Mermaid valides expliquant le flux de données. Je ressentais cette satisfaction que tout développeur connaît lorsque le README.md est peaufiné à la perfection.

Puis, une notification Slack de mon chef de projet est apparue :

« Hé, super travail sur la doc. Peux-tu me l'envoyer sous forme de document Word ? L'équipe juridique doit la revoir avec le "Suivi des modifications" activé, et ils n'utilisent pas Markdown. »

J'ai soupiré. « Bien sûr, donne-moi cinq minutes. »

Célèbres dernières paroles.

Le cauchemar des « cinq minutes »

J'ai ouvert mon terminal et lancé une commande Pandoc rapide. pandoc docs.md -o docs.docx

J'ai ouvert le résultat dans Word. Mon cœur s'est serré.

• Les tableaux étaient cassés. Les colonnes étaient écrasées et les en-têtes étaient désalignés.
• Les diagrammes avaient disparu. Mes beaux graphiques Mermaid n'étaient plus que des blocs de code nus.
• La coloration syntaxique s'était envolée. Le code Python ressemblait à du texte brut, difficile à lire.

« D'accord, » pensai-je. « Je vais essayer un convertisseur en ligne. »

J'ai cherché « Markdown to Word converter » sur Google et j'ai cliqué sur le premier résultat. Il m'a demandé de télécharger mon fichier. Je me suis arrêté. Ce document contenait des points de terminaison d'API internes et une logique propriétaire. Il n'était pas question que je télécharge cela sur un serveur aléatoire sans politique de confidentialité claire.

Alors, j'ai fait ce que tout développeur désespéré ferait. J'ai ouvert Word sur un écran, VS Code sur l'autre, et j'ai commencé à copier-coller.

J'ai passé les deux heures suivantes à indenter manuellement les listes, à faire des captures d'écran de mes diagrammes pour les coller sous forme d'images et à réappliquer les styles gras. À 1 heure du matin, j'étais épuisé et frustré. Je ne codais pas ; je me battais avec un logiciel de traitement de texte.

La réalisation

Cette nuit-là, j'ai réalisé deux choses :

1. Markdown est génial pour écrire, mais le monde fonctionne sous Word. Nous ne pouvons pas y échapper.
2. Les outils existants vous obligent à choisir : soit passer des heures à configurer des outils CLI comme Pandoc, soit sacrifier votre vie privée aux convertisseurs cloud.

Je ne voulais ni l'un ni l'autre. Je voulais un outil qui respectait ma vie privée (traitement local) et respectait mon formatage (support GFM).

C'est ainsi que j'ai créé MarkFlow.

Le construire pour moi (et pour vous)

J'ai commencé à construire MarkFlow comme un petit utilitaire pour mon propre usage. L'objectif était simple :

• Il doit être local. Je veux convertir des contrats sensibles ou une documentation complète sans que les données ne quittent jamais mon navigateur.
• Il doit gérer les choses « délicates ». Les tableaux, les listes de tâches et, oui, la coloration syntaxique des blocs de code.
• Il doit être rapide. Glisser, déposer, terminé.

Lorsque j'ai montré la première version à ma collègue, ses yeux se sont illuminés. « Attends, ça garde le formatage du tableau ? Et je n'ai pas besoin d'installer Python ? »

C'est là que j'ai su que cela ne devait pas rester juste un script sur mon ordinateur portable.

Pourquoi le « Local-First » compte pour moi

En 2026, la confidentialité des données n'est pas un luxe ; c'est une exigence. J'ai construit MarkFlow avec une architecture unique où le moteur de conversion s'exécute directement dans votre navigateur web.

Lorsque vous utilisez MarkFlow, vous ne m'envoyez pas votre fichier. Vous utilisez essentiellement une application puissante qui se trouve être hébergée sur un site web. Cela signifie que vous pouvez convertir vos NDA, projets de brevets et journaux privés sans aucune crainte de fuite de données.

De ma frustration à votre productivité

Aujourd'hui, MarkFlow est passé de cette frustration nocturne à un outil robuste auquel font confiance des milliers d'utilisateurs.

• Plus de tableaux cassés.
• Plus de couleurs de code manquantes.
• Plus d'anxiété liée à la confidentialité.

J'ai créé ceci pour que vous n'ayez jamais à passer votre mardi soir à vous battre avec le formatage Word. Concentrez-vous sur le contenu ; laissez MarkFlow gérer la présentation.

Essayez-le avec votre dernier fichier .md. J'espère que cela vous fera économiser ces deux heures que je ne récupérerai jamais.

— Le développeur MarkFlow