ultra-tv
Lecteur IPTV pour Android TV / Google TV, smartphone, tablette, Windows et Mac — Xtream Codes et M3U. Guide TV, replay, pause du direct, profils, Google TV, multilingue.
- 95
- Kotlin
- MIT
- 13 h ago
Éditeur Markdown multi-plateforme (macOS & Windows) avec aperçu live, export PDF/HTML, KaTeX, Mermaid — Electron + CodeMirror 6
Repo vantaflow/md-reader, read from GitHub 8 h ago. vantaflow has not joined Take My Repo.
vantaflow/md-reader is a public repo on GitHub by vantaflow. Éditeur Markdown multi-plateforme (macOS & Windows) avec aperçu live, export PDF/HTML, KaTeX, Mermaid — Electron + CodeMirror 6. It declares the MIT license on GitHub. It is written mainly in JavaScript, has 1 stars and last changed on 2026-10-26. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-22.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
Éditeur Markdown de bureau, multi-plateforme (macOS & Windows), avec aperçu en temps réel, export PDF, HTML & Word, coloration syntaxique, KaTeX, Mermaid et thème clair/sombre.
Construit avec Electron + CodeMirror 6 + marked + highlight.js + KaTeX + Mermaid.
1.10.0 — édition façon Word
Cmd/Ctrl+Shift+M) : on écrit directement dans une page A4 mise en forme, le fichier reste du Markdown1.9.0 — écriture, navigation, partage, confort
:nom:, modèles, snippets, correcteur FR/EN[[note]] et rétroliens, favoris et tags, rechercher/remplacer dans un dossierF5), copie en HTML riche, import Word et HTML1.8.0 — réglages et menus
Cmd/Ctrl+,), menus Affichage, Format, Aide et documents récents, barre de mise en formeimages/1.7.1 — aperçu en pages A4 par défaut ; une liste ou un tableau plus long qu'une page se coupe d'une feuille à l'autre
Prévu
images/ à l'enregistrement au lieu de rester intégréesPistes à l'étude
{{date}}, {{version}}, variables du front-matter) et fusion de plusieurs documents en un seul PDFCmd/Ctrl+F)Cmd/Ctrl+B), italique (I), souligné (U), lien (K), barré (Shift+X), titres (Alt+1 à Alt+3), listes (Shift+8 / 7 / 9), image (Shift+I), tableau (Alt+T), bloc de code (Alt+C), citation (Shift+.), saut de page (Entrée)images/ à côté du document (nom horodaté, ou nom d'origine sans jamais écraser un fichier existant) et le lien  est inséré. Si le document n'est pas encore enregistré, l'application propose de l'enregistrer d'abord. Formats : PNG, JPEG, GIF, WebP, SVG, 25 Mo au plus ; l'écriture reste bornée au dossier du documentCmd/Ctrl+,, menu, palette) : police, taille, retour à la ligne, numéros de ligne, tabulation et barre d'outils de l'éditeur ; mode d'affichage par défaut, police et taille de l'aperçu, marges des feuilles A4, thème clair / sombre / système ; valeurs par défaut de l'export PDF ; enregistrement automatique et son délai, synchronisation du défilement, réouverture des onglets au démarrage. Tout s'applique immédiatementCmd/Ctrl+Shift+P) : toutes les actions de l'application, joignables au clavier, avec recherche floueÉchap en sort, ou ferme d'abord la palette de commandes si elle est ouverteCmd/Ctrl+Shift+F) : éditeur, panneau et en-tête masqués, l'aperçu occupe toute la fenêtreCmd/Ctrl+Shift+D) : l'éditeur seul, centré, sans autre élément ; Échap quitte ces deux modes--- title: … ---)Un second mode d'édition, à côté du mode code : le document s'édite directement dans une page A4 mise en forme (façon Word / Typora), sous un ruban à trois onglets. Le fichier reste du Markdown : le mode code et le mode Document sont deux vues du même texte.
Bascule : bouton « Mode Document » de l'en-tête, menu Affichage, palette (Mode Document, Mode code, Basculer…, Cmd/Ctrl+Maj+M) et Réglages > Éditeur > Mode d'édition par défaut.
Base technique : ProseMirror (modules prosemirror-*, MIT), bundlé par esbuild comme l'éditeur de code (renderer/document-bundle.js). Choisi plutôt que TipTap (surcouche supplémentaire sans bénéfice ici) et Milkdown (chaîne remark + ProseMirror, moins de maîtrise sur la réécriture) : le schéma, l'analyse (lexeur marked, le même moteur que l'aperçu) et la sérialisation sont écrits sur mesure dans renderer/document/, ce qui garantit l'aller-retour.
Aller-retour sans perte : titres, paragraphes, listes (puces, numérotées, tâches, imbriquées), tableaux (alignements), code, citations, liens, images, encadrés (> [!NOTE] et :::note), notes de bas de page, formules, diagrammes Mermaid, front-matter, sauts de page, sommaire [[toc]], liens wiki et HTML en ligne. Un document non modifié revient à l'octet près ; modifié, il est réécrit de façon canonique (puces -, 1., tableaux compacts…). Ce qui n'a pas d'équivalent (HTML en bloc, directives inconnues, définitions de liens…) est gardé tel quel dans un « bloc brut » modifiable par double-clic.
Ruban — Accueil : annuler / rétablir, police, taille, gras / italique / souligné / barré / code, couleur du texte, surlignage, listes (puces, numéros, tâches), retraits, alignement, styles (Normal, Titre 1-3, Citation, Code), effacer la mise en forme. Insertion : tableau (choix de taille), image, diagramme, lien, saut de page, ligne horizontale, symbole / emoji, sommaire, note de bas de page, formule, encadré. Mise en page : format, marges, orientation, en-tête, pied de page, numéros de page — ce sont les réglages de l'export PDF et de l'aperçu A4 (et ils se retrouvent dans l'export Word) — et « Styles du document… ».
Mise en forme ponctuelle : police, taille, couleur, surlignage et souligné d'une sélection s'écrivent en HTML en ligne (<span style="…">, <u>, <mark>) et sont conservés dans l'aperçu, les exports PDF / HTML et l'export Word. Alignement et retrait : enveloppe <div align="center" style="margin-left:2em"> autour du paragraphe.
Styles du document : police, taille (points), couleur-titres et couleur-texte dans le front-matter, appliqués à l'aperçu, au mode Document et aux exports PDF, HTML et Word :
---
title: Rapport
police: Georgia, serif
taille: 12
couleur-titres: "#1a5276"
couleur-texte: "#222222"
---
Tableaux : ajouter / supprimer lignes et colonnes, alignement de colonne, ligne d'en-tête, menu contextuel (clic droit), Tab pour passer à la cellule suivante. La fusion de cellules n'existe pas : le Markdown ne sait pas la représenter, l'entrée du menu est affichée désactivée avec cette explication.
Éditeur de diagramme visuel (Mermaid, sans code) : modale ouverte depuis Insertion, menu Format, palette, barre d'outils du mode code, double-clic sur un diagramme de l'aperçu ou de la page. Organigramme : nœuds (rectangle, arrondi, losange, cercle), texte, liens (flèche, trait, pointillé, épais) avec texte, direction TB / LR / BT / RL, déplacement sur le canevas, liaison par glisser depuis la poignée, par Maj+clic ou par le bouton « Relier », aperçu Mermaid en direct. Séquence : participants et messages en liste. Les positions sont mémorisées dans un commentaire %% mdr:pos. Un diagramme non reconnu (sous-graphes, styles, notes, boucles…) s'ouvre en lecture seule avec un message et n'est jamais réécrit.
Raccourcis : Cmd/Ctrl+B / I / U, Cmd/Ctrl+K (lien), Cmd/Ctrl+Alt+1..3 (titres), listes Cmd/Ctrl+Maj+7/8/9, Cmd/Ctrl+Entrée (saut de page), Cmd/Ctrl+Z et Cmd/Ctrl+Maj+Z ; le menu Édition > Annuler / Rétablir utilise le même historique.
Limites connues : pas de fusion de cellules ; l'alignement et le retrait ne s'appliquent pas aux éléments de liste ni aux cellules ; les pages sont indiquées par un trait tous les 297 mm (pas de pagination exacte à l'écran, l'aperçu A4 et le PDF restent la référence) ; pas de recherche dans le document en mode Document (utiliser le mode code) ; les emoji :nom: restent du texte dans la page ; un lien de référence [x][ref] est converti en lien direct, sa définition est conservée en fin de document ; les fins de ligne et le front-matter sont conservés, mais un document modifié est réécrit en forme canonique ; la largeur des tableaux de l'export Word suppose une page A4.
Cmd/Ctrl+Alt+Shift+T) : une grille de cellules modifiables, ajout et suppression de lignes et de colonnes, alignement par colonne (gauche, centre, droite). Il s'ouvre sur le tableau Markdown sous le curseur (qu'il remplace, colonnes alignées, à « Appliquer ») ou en crée un nouveauCmd/Ctrl+Alt+Shift+F pour le document, Cmd/Ctrl+Alt+Shift+R pour la sélection) : listes numérotées renumérotées, puces homogènes (-), tableaux alignés, espaces de fin retirés, lignes vides multiples réduites. Les blocs de code et le front-matter ne sont jamais touchés ; un saut de ligne forcé (deux espaces en fin de ligne, suivis d'une ligne de texte) est conservé. L'annulation (Cmd/Ctrl+Z) rétablit l'état d'avant:nom: (environ 350 noms courants, à la GitHub) est proposé après :xx dans l'éditeur et converti dans l'aperçu et les exports, jamais dans le code ni dans un bloc de code ; le texte source reste :nom:]( ou [[, l'éditeur propose les .md du dossier ouvert (à défaut, du dossier du document) et insère le chemin relatif au document, ou le nom de la note. Le parcours est borné (4 niveaux, 500 fichiers, dossiers cachés et node_modules ignorés) et ne lit aucun contenusnippets.json du dossier de données de l'application ; quelques exemples au premier lancement ; {{date}} est remplacé par la date du jour# à ######, hors blocs de code et front-matter). Un clic place le curseur de l'éditeur sur le titre et fait défiler l'aperçu jusqu'à la section ; la section qui contient le curseur est surlignée. Glisser une entrée sur une autre déplace la section avec ses sous-sections, avant ou après la cible selon la moitié survolée ; le niveau de la section déplacée s'aligne sur celui de la cible (ses sous-sections suivent, entre 1 et 6) ; un seul Cmd/Ctrl+Z annule le déplacement. Les titres soulignés (===, ---) ne forment pas de section[[note]] et [[note|texte]] : rendus en liens dans l'aperçu (jamais dans le code), cliquables. La note est cherchée par nom de fichier, sans extension et sans tenir compte de la casse, d'abord dans le dossier du document puis dans tout le dossier ouvert (à défaut de dossier ouvert, dans celui du document) ; elle s'ouvre dans un onglet. Une note introuvable est proposée à la création (après confirmation), à côté du document, avec un nom de fichier nettoyé (jamais hors de ce dossier). [[note#Section]] ouvre la note sur la section. [[toc]] reste réservé au sommaire.md du dossier ouvert qui citent le document courant par [[nom]] ou par un lien relatif, avec un extrait de la ligne ; un clic ouvre le document. Le scan est confiné au dossier ouvert (4 niveaux, 500 fichiers, 2 Mo par fichier, 100 résultats), en lecture seuletags: [a, b], tags: a, b ou liste YAML - a) des .md du dossier ouvert sont proposés dans l'onglet Fichiers ; cliquer sur un tag filtre l'arborescence (plusieurs tags se cumulent), le champ de saisie restreint la liste des tags et le filtre ; « Effacer le filtre » rétablit l'arbre. Seuls les 16 premiers Ko de chaque fichier sont lus$1, $&). Aperçu des changements affiche, par fichier, chaque occurrence avant/après (ligne par ligne) avec une case à cocher par fichier et par occurrence ; Appliquer demande confirmation puis écrit. Le remplacement ne touche que les .md du dossier ouvert (tout chemin hors dossier est refusé), écrit de façon atomique (fichier temporaire puis renommage) et relit chaque fichier : un fichier modifié depuis l'aperçu est sauté et signalé. Un fichier dont l'onglet a des modifications non enregistrées est ignoré ; les autres onglets concernés sont rechargés. Bornes : 500 caractères de recherche, 2 000 de remplacement, 500 occurrences par fichier, 5 000 au total, 2 Mo par fichier ; une expression invalide ou qui reconnaît la chaîne vide affiche un message, sans exception ; la recherche d'un document est limitée à 1,5 s : une expression à retour arrière catastrophique (comme (a+)+$) est interrompue et signalée (« trop de temps à s'exécuter ») au lieu de figer l'application</style>, <script>, commentaires HTML) et toute règle @import en sont retirées avant l'insertionCmd/Ctrl+Alt+Shift+C) : la sélection (ou le document entier, sans son front-matter, quand rien n'est sélectionné) est rendue en HTML aux styles en ligne — titres, tableaux avec bordures et border="1", code, citations, liens, images en data URI — et posée dans le presse-papiers avec text/html et text/plain (le Markdown source). Les clients de courrier ignorent les feuilles de style, d'où les styles en ligne. Limite : le collage réel dans Outlook, Teams ou Word n'a pas été testé (les tests relisent le contenu du presse-papiers système, pas le résultat dans ces applications) ; les diagrammes Mermaid et les formules KaTeX ne sont pas convertis en images pour la copiemimetype en premier et non compressé, META-INF/container.xml, content.opf avec titre, auteur et langue lus du front-matter — title, author, lang —, nav.xhtml pour la table des matières, un chapitre par titre 1, feuille de style, images rangées dans OEBPS/images). Le HTML rendu est converti en XHTML valide (balises vides auto-fermées, entités, scripts et gestionnaires retirés) ; un lien interne vers un autre chapitre est réécrit vers son fichier. Les images locales et intégrées sont incluses ; une image distante (http) est remplacée par son texte alternatif ; les diagrammes Mermaid sont inclus en SVG (certaines liseuses n'affichent pas le texte des diagrammes). Les tests vérifient l'archive et la validité XML (DOMParser) ; l'ouverture dans une liseuse réelle n'a pas été testéeF5) : une ligne qui ne contient que --- sépare deux slides (sauf dans le front-matter, dans un bloc de code, et sous une ligne de texte où elle reste un titre de niveau 2 — laissez une ligne vide avant --- pour séparer). Vue plein écran avec le rendu Markdown de la slide ; → ↓ Espace PageDown Entrée : suivante ; ← ↑ PageUp : précédente ; Début / Fin ; G : aperçu en vignettes (un clic saute à la slide) ; Échap : sortir ; le numéro 3 / 12 s'affiche en bas à droiteon… et liens javascript: retirés). Le résultat s'ouvre dans un nouvel onglet non enregistré. Images d'un .docx : elles restent intégrées au Markdown en data URI (l'onglet n'étant pas enregistré, il n'y a pas encore de dossier images/ où les écrire) ; le fichier source est lu par le processus principal, limité à 50 Mo, et un fichier invalide affiche un message sans exception. Un test relit un .docx exporté par l'application (titres, listes, tableau, gras, image conservés)historique/<empreinte du chemin>/<horodatage>.md. Un contenu identique au dernier instantané n'est pas dupliqué ; au plus 50 versions par document sont gardées (les plus anciennes sont supprimées), 5 Mo au plus par version. La fenêtre liste les versions (date, taille), affiche le contenu (Aperçu) ou la comparaison ligne à ligne avec le texte actuel (lignes ajoutées en vert, supprimées en rouge barré). Restaurer prend d'abord un instantané de l'état courant (même non enregistré), puis remplace le contenu de l'éditeur en une seule transaction : Cmd/Ctrl+Z revient en arrière. Un document non enregistré affiche un message. Les trois canaux IPC (historique:ajouter, historique:lister, historique:lire) n'acceptent qu'un chemin markdown absolu, un texte et un identifiant de version au format strictCmd/Ctrl+Alt+L) : l'aperçu en plein écran pour lire ou présenter (distinct du diaporama : pas de découpage en slides). Taille du texte ajustable (A− / A+, touches - et +, de 12 à 56 px), défilement automatique à vitesse réglable de 1 à 10 (Espace : lecture/pause, flèches ↑ ↓ : vitesse) ; la barre de contrôle se masque après 2,5 s sans activité et réapparaît au moindre mouvement ; Échap quitte. Rien n'est mémoriséhttps://api.github.com/repos/vantaflow/md-reader/releases/latest (délai de 8 s, User-Agent explicite), compare les numéros de version (semver, préversions comprises) et la fenêtre annonce « Vous avez la dernière version » ou « La version X est disponible » avec les notes de version (affichées en texte brut). Télécharger ouvre dans le navigateur l'installeur de votre système (.dmg arm64 ou x64 sur macOS, Setup … .exe sur Windows) ou, à défaut, la page de la version ; l'adresse est revalidée côté principal (https, github.com/vantaflow/md-reader/ uniquement) et l'installation n'est jamais lancée sans votre clic ni par l'application. Les cas « aucune release publiée » (404), limite de requêtes de GitHub, erreur réseau, délai dépassé et réponse invalide affichent chacun un message. Réglage Réglages → Général → « Vérifier les mises à jour au démarrage » (désactivé par défaut) : au plus une vérification par jour, silencieuse sauf si une version plus récente existe. Limite : les tests simulent fetch (réponses, 404, 403, erreurs, JSON invalide, délai) ; l'appel réel à GitHub, l'ouverture réelle du navigateur et l'installation d'une mise à jour n'ont pas été testés, et aucune release n'est publiée par ce chantier$inline$ et $$block$$)Texte[^1] + [^1]: la note), rejetées en fin de document> [!NOTE], [!TIP], [!IMPORTANT], [!WARNING], [!CAUTION] — syntaxe GitHub et Obsidian, :::note également accepté[[toc]] (titres 1 à 3)Cmd/Ctrl+T), appliqué à l'éditeur, l'aperçu et les diagrammes.md, pas à l'application<!-- pagebreak --> — affiché comme un repère dans l'aperçu, appliqué à l'impression.md d'un dossier.md dans le Finder / l'Explorateur, ou « Ouvrir avec »[[toc]] exporté porte le numéro de page réel de chaque titre, lu dans le PDF lui-même plutôt que devinétitle, subtitle, author, date)1., 1.2, 1.2.3…), en optionCmd/Ctrl+P) vers l'imprimante systèmenote.md et note.markdown visant le même note.pdf : le fichier gardé est celui qui vient en premier dans l'ordre alphabétique — ici note.markdown avant note.md — l'autre est ignoré et compté en conflit). Sa progression s'affiche dans la barre d'outils et dans une notification dédiée qui reste visible même en mode focus.md ouvert depuis l'extérieur ne peut ni exécuter de <script>, ni déclencher un onerror=, ni charger une ressource distantesecurityLevel: 'strict' : pas de HTML arbitraire dans les libellés de diagrammeBarre d'outils (en-tête)
| Bouton | Rôle |
|---|---|
| ☰ | Afficher / masquer le panneau latéral |
| 📄 Ouvrir | Ouvrir un fichier Markdown |
| 📁 Dossier | Ouvrir un dossier (explorateur + recherche) |
| 💾 Enregistrer | Enregistrer l'onglet courant |
| Exporter en PDF (ouvre les options) | |
| 🌐 HTML | Exporter en HTML autonome |
| ⭐ Défaut | Définir MD Reader comme lecteur Markdown par défaut (macOS) |
| ☑ Code | Afficher / masquer le volet éditeur |
| ☑ Sync | Synchroniser le défilement éditeur ↔ aperçu |
| ☑ Autosave | Enregistrement automatique |
| Continu / A4 · 1 page / A4 · 2 pages | Mode d'affichage de l'aperçu |
| 🌓 | Basculer le thème clair / sombre |
Les réglages complets s'ouvrent avec Cmd/Ctrl+,.
Panneau latéral — sa largeur se règle en glissant son bord droit (double-clic pour revenir à la largeur par défaut). Trois onglets :
MD Reader peut s'enregistrer comme application par défaut pour les fichiers Markdown (.md, .markdown, .mdown, .mkd).
NSWorkspace.setDefaultApplication via le compilateur Swift système — aucune dépendance tierce. Fonctionne uniquement sur l'application installée (pas en mode npm start)..md dans le Finder ouvre le fichier dans un nouvel onglet.Les associations de fichiers sont déclarées dans
package.json(build.fileAssociations) et, pour macOS, dansbuild.mac.extendInfo.CFBundleDocumentTypes.
Ces réglages sont conservés d'une session à l'autre, dans un magasin unique (localStorage, clé reglages, migré depuis les anciennes clés) et modifiables dans la fenêtre Réglages. Les documents récents sont mémorisés à part, dans le dossier de données de l'application :
| Préférence | Défaut | Détail |
|---|---|---|
| Thème | Clair | Clair, sombre ou système |
| Volet Code | Masqué | L'app démarre en mode aperçu ; réafficher le volet le mémorise |
| Panneau latéral | Visible | Réductible via ☰, état retenu |
| Largeur du panneau | 240 px | Réglée en glissant son bord droit (140 px au minimum) |
| Mode d'affichage | A4 une page | Continu, A4 une page ou A4 deux pages |
| Éditeur | Police et taille, retour à la ligne, numéros de ligne, tabulation, barre d'outils | Voir Réglages → Éditeur |
| Aperçu | Police, taille, marges des feuilles A4 | Voir Réglages → Aperçu |
| Export PDF | Format, orientation, marges, numéros de page, page de garde, filigrane | La modale d'export s'ouvre pré-remplie |
| Général | Enregistrement automatique et délai, synchro du défilement, onglets rouverts, objectif de mots, vérification des mises à jour au démarrage (désactivée) | Voir Réglages → Général |
La fenêtre s'ouvre maximisée au démarrage.
| Action | Raccourci |
|---|---|
| Réglages | Cmd/Ctrl+, |
| Nouvel onglet | Cmd/Ctrl+N |
| Ouvrir fichier | Cmd/Ctrl+O |
| Ouvrir dossier | Cmd/Ctrl+Shift+O |
| Enregistrer | Cmd/Ctrl+S |
| Enregistrer sous… | Cmd/Ctrl+Shift+S |
| Fermer onglet | Cmd/Ctrl+W |
| Export PDF | Cmd/Ctrl+E |
| Export HTML | Cmd/Ctrl+Shift+E |
| Imprimer | Cmd/Ctrl+P |
| Palette de commandes | Cmd/Ctrl+Shift+P |
| Basculer volet code | Cmd/Ctrl+/ |
| Basculer thème | Cmd/Ctrl+T |
| Rechercher (dans l'éditeur) | Cmd/Ctrl+F |
| Gras | Cmd/Ctrl+B |
| Italique | Cmd/Ctrl+I |
| Lien | Cmd/Ctrl+K |
| Souligné | Cmd/Ctrl+U |
| Barré | Cmd/Ctrl+Shift+X |
| Titre 1 / 2 / 3 | Cmd/Ctrl+Alt+1 / 2 / 3 |
| Liste à puces / numérotée / de tâches | Cmd/Ctrl+Shift+8 / 7 / 9 |
| Image | Cmd/Ctrl+Shift+I |
| Tableau | Cmd/Ctrl+Alt+T |
| Bloc de code | Cmd/Ctrl+Alt+C |
| Citation | Cmd/Ctrl+Shift+. |
| Saut de page | Cmd/Ctrl+Enter |
| Éditeur de tableau | Cmd/Ctrl+Alt+Shift+T |
| Reformater le document / la sélection | Cmd/Ctrl+Alt+Shift+F / R |
| Copier en HTML riche | Cmd/Ctrl+Alt+Shift+C |
| Diaporama | F5 |
| Mode présentation lecture | Cmd/Ctrl+Alt+L |
| Aperçu seul plein écran | Cmd/Ctrl+Shift+F |
| Éditeur seul sans distraction | Cmd/Ctrl+Shift+D |
| Zoom de l'interface | Cmd/Ctrl+Plus / - / 0 |
| Outils de développement | F12 (macOS : Alt+Cmd+I) |
| Quitter un mode plein écran, focus ou une modale | Échap |
La liste complète est aussi dans Aide → Raccourcis clavier, générée depuis la table unique renderer/lib/raccourcis.js.
Les installateurs sont disponibles dans l'onglet Releases du dépôt :
MD.Reader-<version>-arm64.dmg (Apple Silicon) ou MD.Reader-<version>-x64.dmg (Intel)MD.Reader.Setup.<version>.exe (installateur NSIS)Dernière version : v1.10.0. L'application n'est pas signée par Apple : au premier lancement sur macOS, faites clic droit → Ouvrir (ou xattr -dr com.apple.quarantine "/Applications/MD Reader.app").
# 1. Cloner le dépôt
git clone https://github.com/vantaflow/md-to-pdf-app.git
cd md-to-pdf-app
# 2. Installer les dépendances
npm install
# 3. Lancer en mode développement
npm start
.dmg pour macOSnpm run build:mac
Le .dmg est produit dans dist/ (versions arm64 et x64).
ℹ️ Apple Silicon vs Intel : le build génère les deux architectures. Installez celle correspondant à votre Mac (
arm64pour M1/M2/M3/M4,x64pour Intel).
⚠️ Gatekeeper : l'application n'est pas signée avec un certificat Apple Developer. Au premier lancement, faites clic droit → Ouvrir, puis confirmez. Pour signer et notariser, définissez
CSC_LINK,CSC_KEY_PASSWORD,APPLE_ID,APPLE_APP_SPECIFIC_PASSWORDavantnpm run build:mac.
# 1. Cloner le dépôt
git clone https://github.com/vantaflow/md-to-pdf-app.git
cd md-to-pdf-app
# 2. Installer les dépendances
npm install
# 3. Lancer en mode développement
npm start
.exe pour Windowsnpm run build:win
L'installateur NSIS est produit dans dist\MD-to-PDF-Setup-<version>.exe.
💡 Windows Defender SmartScreen : l'installateur n'étant pas signé, SmartScreen peut afficher un avertissement. Cliquez sur Informations complémentaires → Exécuter quand même. Pour signer, définissez
CSC_LINKetCSC_KEY_PASSWORDavant le build.
ℹ️ Build cross-platform : le build Windows est à exécuter sur Windows, le build macOS sur un Mac.
Un workflow GitHub Actions (.github/workflows/release.yml) construit et publie automatiquement les installateurs (DMG macOS + NSIS Windows) à chaque tag de version.
# Bump de version dans package.json, puis :
git tag v<version> # la même que celle de package.json, sans quoi la release ment
git push origin v<version>
Le push d'un tag v* déclenche le build multi-OS et attache les artefacts à la Release GitHub correspondante.
md-to-pdf-app/
├── main.js # Process principal Electron (IPC, fenêtres, export PDF/HTML/Word,
│ # ouverture système, documents récents, lecteur par défaut)
├── menu.js # Gabarit des menus natifs et liste des documents récents (sans Electron)
├── images.js # Enregistrement borné des images collées dans images/ (sans Electron)
├── contexte.js # Menu contextuel et langues du correcteur orthographique (sans Electron)
├── remplacement.js # Rechercher/remplacer : expressions, occurrences avant/après, bornes (sans Electron)
├── importation.js # Lecture bornée (50 Mo) d'un fichier à importer (sans Electron)
├── presse-papiers.js # Validation et écriture du presse-papiers HTML riche (sans Electron)
├── historique.js # Historique des versions : instantanés, plafond, lecture bornée (sans Electron)
├── miseajour.js # Vérification des mises à jour : API GitHub, semver, adresse revalidée (sans Electron)
├── donnees.js # Snippets (snippets.json), liste bornée des .md d'un dossier, tags et rétroliens (sans Electron)
├── preload.js # Bridge contextIsolation entre main et renderer
├── pdf.js # Options de rendu, lecture des destinations d'un PDF,
│ # remplissage des numéros de page (sans Electron)
├── renderer/
│ ├── index.html # Shell de l'UI
│ ├── styles.css # Thèmes clair/sombre, layout en grille
│ ├── commands.js # Registre des commandes lu par la palette (boutons/menus/accélérateurs restent câblés séparément)
│ ├── lib/ # Logique pure, testable sans Electron :
│ │ ├── settings.js # magasin des réglages (valeurs par défaut, migration, onChange)
│ │ ├── raccourcis.js # table unique des raccourcis (menus, aide, éditeur)
│ │ ├── format.js # mise en forme Markdown (gras, titres, listes, tableau…)
│ │ ├── tableau.js # tableaux GFM : analyse, sérialisation alignée, repérage
│ │ ├── reformat.js # reformatage du Markdown
│ │ ├── plan.js # sections du texte source et déplacement d'une section
│ │ ├── wiki.js # liens wiki : analyse, résolution d'une note, rétroliens
│ │ ├── tags.js # tags du front-matter, comptage, filtrage de l'arbre
│ │ ├── emoji.js # table des emoji :nom:, suggestions, remplacement
│ │ ├── liens.js # chemins relatifs et noms de notes pour les liens
│ │ ├── modeles.js # modèles de documents
│ │ ├── snippets.js # snippets : assainissement, ajout, suppression
│ │ ├── themes-export.js # thèmes d'export PDF/HTML et nettoyage du CSS personnalisé
│ │ ├── html-riche.js # HTML aux styles en ligne pour « Copier en HTML riche »
│ │ ├── epub.js # construction de l'archive EPUB 3 (XHTML, OPF, nav)
│ │ ├── diaporama.js # découpage en slides et options PDF 16:9
│ │ ├── import.js # nettoyage du HTML importé, conversion turndown
│ │ ├── diff.js # comparaison ligne à ligne (historique)
│ │ ├── lecture.js # mode présentation lecture : taille, vitesse, défilement
│ │ └── statistiques.js # statistiques avancées : lisibilité, objectif, temps par section
│ ├── features/ # Fonctions de l'interface, chargées avant renderer.js :
│ │ ├── reglages.js # fenêtre Réglages
│ │ ├── format.js # commandes Format et barre d'outils
│ │ ├── aide.js # aide-mémoire, raccourcis, À propos
│ │ ├── export-docx.js # export Word
│ │ ├── modes.js # aperçu seul plein écran, éditeur sans distraction
│ │ ├── images.js # images collées ou glissées
│ │ ├── modale.js # modales génériques : fenêtre, saisie, choix dans une liste
│ │ ├── tableau.js # éditeur de tableau visuel
│ │ ├── reformat.js # commandes de reformatage
│ │ ├── plan.js # panneau Plan : clic, section courante, glisser-déposer
│ │ ├── wiki.js # clic sur les liens wiki, panneau Rétroliens
│ │ ├── favoris.js # fichiers épinglés
│ │ ├── tags.js # filtre par tags dans l'onglet Fichiers
│ │ ├── remplacer.js # rechercher/remplacer dans le dossier, aperçu et application
│ │ ├── rendu.js # rendu détaché partagé (copie HTML riche, EPUB, diaporama, 1.9.0)
│ │ ├── copier-html.js # Copier en HTML riche
│ │ ├── export-epub.js # Export EPUB
│ │ ├── diaporama.js # Diaporama plein écran et export PDF des slides
│ │ ├── import.js # Importer un .docx ou un .html en Markdown
│ │ ├── liens.js # propositions de liens vers les .md
│ │ ├── modeles.js # Nouveau depuis un modèle
│ │ ├── snippets.js # Insérer, enregistrer, supprimer un snippet
│ │ ├── correcteur.js # réglage du correcteur orthographique
│ │ ├── historique.js # historique des versions : liste, aperçu, comparaison, restauration
│ │ ├── lecture.js # mode présentation lecture
│ │ ├── statistiques.js # fenêtre des statistiques avancées
│ │ └── miseajour.js # Rechercher les mises à jour
│ ├── docx-src.js # Conversion HTML vers .docx (bibliothèque docx, bundlée par esbuild)
│ ├── jszip-src.js # Entrée navigateur de JSZip pour l'export EPUB (bundlée par esbuild, 1.9.0)
│ ├── import-src.js # Entrée navigateur de mammoth et turndown pour l'import (bundlée par esbuild, 1.9.0)
│ ├── lot2d.css # Styles de l'historique, de la lecture, des statistiques et des mises à jour
│ ├── docx-bundle.js # Bundle généré (ignoré par git)
│ ├── editor-src.js # Source CodeMirror 6 (bundlée par esbuild)
│ ├── editor-bundle.js # Bundle généré (ignoré par git)
│ ├── markdown/ # Moteur de rendu : parse.js, enhance.js, labels.js, icons.js
│ ├── markdown-src.js # Entrée navigateur du moteur (bundlée par esbuild)
│ ├── markdown-bundle.js # Bundle généré (ignoré par git)
│ └── renderer.js # Logique UI : onglets, aperçu, marked, mermaid, katex,
│ # TOC, recherche, préférences
├── build/
│ ├── icon.html # Source de l'icône (SVG)
│ ├── make-icon.js # Rend l'icône en PNG 1024 via Electron
│ ├── icon.png / icon.icns # Icônes consommées par electron-builder
├── test/markdown.test.js # Tests unitaires du moteur Markdown, sans Electron
├── test/pdf.test.js # Tests unitaires de la chaîne PDF, sans Electron
├── test/packaging.test.js # Cohérence du manifeste et du verrou de dépendances
├── test/settings.test.js # Réglages : défauts, migration, validation
├── test/format.test.js # Mise en forme Markdown
├── test/menu.test.js # Menus, raccourcis, documents récents
├── test/images.test.js # Images collées : noms, collisions, écriture bornée
├── test/tableau.test.js # Tableaux GFM
├── test/export-partage.test.js # Thèmes d'export, CSS personnalisé, HTML riche, presse-papiers
├── test/import.test.js # Import : nettoyage du HTML hostile, conversion, lecture bornée
├── test/epub-diaporama.test.js # EPUB (archive, XHTML), diaporama (découpage, HTML et options PDF)
├── test/reformat.test.js # Reformatage Markdown
├── test/ecriture.test.js # Emoji (table, rendu) et liens relatifs
├── test/modeles-snippets.test.js # Modèles, snippets, menu contextuel, liste des .md
├── test/plan.test.js # Plan du document : sections, déplacement
├── test/navigation.test.js # Liens wiki, rétroliens, tags, rendu des liens wiki
├── test/dossier.test.js # IPC bornées du dossier ouvert : tags, rétroliens
├── test/remplacement.test.js # Rechercher/remplacer : expressions, groupes, bornes
├── test/remplacement-dossier.test.js # Aperçu et application dans un dossier : confinement, empreinte
├── test/historique.test.js # Historique des versions : instantanés, plafond, confinement
├── test/statistiques.test.js # Statistiques avancées : lisibilité, objectif, temps par section
├── test/miseajour.test.js # Mises à jour : semver, réponses GitHub simulées, adresse refusée
├── test/helpers.js # Aide commune aux tests Electron (fenêtre invisible, check)
├── test/smoke.js # Test de fumée end-to-end, sous Electron
├── test/smoke-lot1.js # Réglages, menus, barre de mise en forme, préférences
├── test/smoke-docx.js # Export Word
├── test/smoke-focus.js # Modes aperçu seul et éditeur sans distraction
├── test/smoke-images.js # Images collées et glissées
├── test/smoke-lot2a.js # Écriture 1.9.0 : tableau, reformatage, emoji, liens, modèles, snippets, correcteur
├── test/smoke-lot2b.js # Navigation 1.9.0 : plan, liens wiki, rétroliens, favoris, tags, rechercher/remplacer
├── test/smoke-lot2c.js # Export et partage 1.9.0 : thèmes, HTML riche, EPUB, diaporama, import
├── test/smoke-lot2d.js # Confort 1.9.0 : historique, mode lecture, statistiques, mises à jour
├── .github/workflows/ci.yml # CI : test de fumée macOS / Linux / Windows
├── .github/workflows/release.yml # CI : build & publication des installateurs
├── installer.iss # Script Inno Setup (installateur Windows alternatif)
├── package.json # Dépendances, scripts, config electron-builder
└── dist/ # Sorties de build (ignorées par git)
Flux d'export PDF
BrowserWindow cachée — un document file:// peut atteindre les polices KaTeX
et les images référencées par le markdown, ce qu'une URL data: ne peut pas.webContents.printToPDF() génère le PDF via le moteur d'impression intégré de Chromium,
avec les signets et le balisage d'accessibilité.[[toc]], une seconde passe a lieu. Un numéro de page ne se
déduit pas du DOM : offsetTop se trompe dès qu'une règle de pagination déplace un
élément. Le PDF, lui, porte la réponse dans sa table de destinations. pdf.js la lit,
remplit les emplacements du sommaire, et le document est rendu une seconde fois. Sans
sommaire, la passe est sautée et l'export garde son coût d'origine.L'impression (Cmd/Ctrl+P) suit le même chemin de mesure avant d'envoyer le document à la
boîte d'impression système, pour que son sommaire porte lui aussi ses numéros de page.
Ouverture depuis le système
open-file (double-clic / « Ouvrir avec »), parfois avant que le renderer soit prêt : les chemins sont mis en file d'attente puis rejoués une fois la fenêtre chargée.| Script | Description |
|---|---|
npm start |
Bundle le renderer + lance l'app en dev |
npm run bundle |
Bundle editor-src.js, markdown-src.js, docx-src.js, jszip-src.js et import-src.js (dans renderer/) vers editor-bundle.js, markdown-bundle.js, docx-bundle.js, jszip-bundle.js et import-bundle.js (esbuild, minifié) |
npm test |
Tests unitaires (moteur Markdown, chaîne PDF, empaquetage, réglages, mise en forme, menus, images, tableaux, reformatage, modèles, plan, navigation, rechercher/remplacer, export et partage, EPUB, import, historique, statistiques, mises à jour ; node --test, sans Electron) puis tests de fumée end-to-end sous Electron (smoke, smoke-lot1, smoke-docx, smoke-focus, smoke-images, smoke-lot2a, smoke-lot2b, smoke-lot2c, smoke-lot2d), tous sans fenêtre visible |
npm run build |
Build des installateurs pour la plateforme courante |
npm run build:mac |
Build .dmg (arm64 + x64) |
npm run build:win |
Build installateur NSIS |
💡 Pour un build local rapide sans générer de
.dmg/.exe:npm run bundle && npx electron-builder --mac --dir(produit l'app dansdist/mac-arm64/).
npm install échoue sur node-gyp / binaires natifs
→ macOS : xcode-select --install. Windows : installer les Build Tools for Visual Studio.
L'app s'ouvre en blanc au démarrage
→ Vérifiez que npm run bundle a bien généré renderer/editor-bundle.js, puis relancez npm start.
Export PDF vide ou mal rendu
→ Ouvrez les DevTools (F12, ou Alt+Cmd+I sous macOS) et vérifiez la console de l'aperçu. Les ressources KaTeX/Mermaid doivent être chargées.
Le bouton ⭐ Défaut ne fait rien / renvoie une erreur
→ La fonction n'est disponible que sur l'application installée (pas en npm start). Sur macOS, autorisez l'app dans Réglages Système → Confidentialité et sécurité si Gatekeeper l'a bloquée.
Erreur electron-builder lors d'un build cross-platform
→ Construisez chaque cible sur sa plateforme native (DMG sur macOS, NSIS sur Windows).
MIT © 2026 vantaflow
Les PR sont bienvenues. Pour les changements importants, ouvrez d'abord une issue pour discuter de la proposition.
vantaflow/md-reader is a public repo on GitHub by vantaflow. Éditeur Markdown multi-plateforme (macOS & Windows) avec aperçu live, export PDF/HTML, KaTeX, Mermaid — Electron + CodeMirror 6.
It declares the MIT license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-10-26. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.

Lecteur IPTV pour Android TV / Google TV, smartphone, tablette, Windows et Mac — Xtream Codes et M3U. Guide TV, replay, pause du direct, profils, Google TV, multilingue.
349 skills open-source pour Claude Code — 34 domaines : dev, agents IA, AI/ML, cloud, database, DevOps, testing, sécurité, networking, Linux, automation, marketing, IoT, communication, data, freelance, management, et vie quotidienne.

Le launcher Android TV complet qui reste fluide sur les petites box — accueil façon Google TV, recommandations, personnalisation poussée. Sans compte Google, sans pub.
Framework d'entreprise Cloud-Native basé sur Clean Architecture, DDD et Multi-tenancy pour applications SaaS professionnelles.

Native Swift cleaner for macOS — fast, transparent, open source. ~4MB binary, zero telemetry, MIT licensed.