Quick Look
Appuyez sur Espace sur n'importe quel fichier Markdown dans le Finder et voyez-le rendu dans votre thème de lecture, avant même d'ouvrir une app.
votre agent
Votre agent écrit des plans.
Relisez-les comme ceux d'un collègue.
Les agents produisent beaucoup de Markdown : plans d'implémentation, specs, synthèses de recherche — de longs documents qui demandent votre jugement avant que quiconque n'agisse dessus. Les moyens existants de le donner conviennent tous mal. La source brute dans un éditeur cache ce qu'un lecteur verrait, coller des extraits dans une conversation coupe le retour de son contexte, et committer un brouillon juste pour obtenir les cadres de commentaire d'une PR relève du cérémonial — tout document n'a pas vocation à finir en pull request.
Les notes de marge placent le retour dans le document lui-même. Lisez le brouillon en page rendue, cliquez là où ça cloche et laissez une note signée, ancrée à ce bloc. Les notes sont de simples commentaires HTML qui restent hors de la page rendue — si bien que « traite mes notes dans le plan » suffit comme passation : votre agent lit chaque note exactement là où vous l'avez laissée. Pas de commit, pas de copier-coller, pas de pull request. Puis regardez la nouvelle version arriver — Comparer surligne les modifications de l'agent mot à mot, en direct à chaque enregistrement.
Toute la boucle — instructions à remettre à votre agent comprises — est déroulée sur la page agents. Les notes de marge sont en bêta, activées par défaut ; la doc en couvre la mécanique.
pourquoi
La prose n'est pas du code.
Arrêtez de la relire comme du code.
Vous connaissez le moment : un mur vert de quarante lignes dans le diff d'un README, et quelque part dedans, la seule phrase qui a vraiment changé. Docs de conception, décisions d'architecture, runbooks, définitions d'agents — chaque semaine, une part croissante de ce qui traverse votre file de révision est de la prose, et un diff source de prose cache précisément ce que vous êtes venu juger.
PullMark vous montre le changement tel que les lecteurs le rencontreront : rendu, avec seuls les mots modifiés surlignés. Les tableaux restent des tableaux, les diagrammes des diagrammes, et une retouche d'un mot est un seul mot surligné. Commentez n'importe quel bloc : le commentaire atterrit sur les lignes exactes qu'attend GitHub — approuvez, demandez des modifications ou laissez des suggestions que l'auteur applique en un clic.
« La salle de lecture à côté de l'atelier. »
Note
PullMark n'est délibérément pas un client de révision complet. Il ne montre que les fichiers Markdown d'une PR — pour la partie code d'un changement, vos outils de révision habituels restent les bons.
révision
Toute la révision de la doc, depuis la page rendue.
Passez de la disposition en ligne à la vue côte à côte, descendez au Diff source brut ou prévisualisez le Résultat final — le tout depuis la barre d'outils, qui vous mène aussi de fichier en fichier et vous ramène à la PR sans toucher à la barre latérale. Le front matter YAML devient un discret tableau de métadonnées, pas un mur de prose en gras — les docs chargées en configuration se diffent donc proprement aussi. Un document tout neuf se lit comme un document — une seule mention dit qu'il est entièrement nouveau, au lieu de teinter chaque bloc en vert. Les fils de révision existants apparaissent sous les blocs qu'ils discutent. Survolez un bloc, cliquez la bulle, et commentez le bloc entier ou exactement les lignes de votre choix. Quand vous avez terminé, Approuver, Demander des modifications ou Commenter, directement depuis la vue d'ensemble — avec ou sans commentaires de ligne — et déposez aussi des commentaires au niveau du fichier ou de simples messages de conversation. La vue d'ensemble montre où en est la PR : approuvée ou modifications demandées, le verdict de chaque réviseur, les checks CI avec un lien vers les journaux de chacun, et la conversation complète en chronologie lisible. Les PR ouvertes sont vérifiées chaque minute ; si la branche avance, un clic rafraîchit et vos brouillons survivent.
Commencer une révision
Le mode par défaut : les brouillons s'accumulent en local. Envoyez-les ensemble — Commenter, Approuver ou Demander des modifications — ou enregistrez une révision en attente à terminer sur github.com.
Ajouter un seul commentaire
Publie immédiatement un commentaire de révision unique, ancré au bloc — ou restreint aux seules lignes que vous sélectionnez dans l'éditeur.
Ajouter une suggestion
Le crayon ouvre la source Markdown d'un bloc dans un éditeur — votre modification
part comme un bloc ```suggestion que l'auteur applique en un clic.
lecture
Un vrai lecteur pour le Markdown déjà sur votre disque.
Vos notes, vos README, le dossier de docs de votre équipe — ouvrez un fichier ou un répertoire entier et lisez-le tel qu'il devait apparaître. Tout se réaffiche à l'instant où le fichier change sur le disque, les images et liens relatifs se résolvent tout seuls, et si GitHub le rend, PullMark le rend :
Gras, italique, barré, code en ligne,
surlignage, H2O, mc2,
eiπ + 1 = 0,
liens avec aperçu au survol, notes de bas de page[1],
listes de tâches — plus les tableaux, les diagrammes Mermaid,
le code coloré, les alertes > [!NOTE], les maths KaTeX hors ligne,
[toc], et le front matter YAML replié en un tableau de métadonnées soigné.
- L'historique dans la marge — une discrète gouttière de blame : un avatar par suite de blocs ; survolez pour l'auteur, la date et le commit ; cliquez pour l'historique complet des lignes.
- Toujours à jour — enregistrez depuis n'importe quel éditeur : la page s'est déjà réaffichée.
- Un diff face à l'historique — un clic compare le fichier de
travail à n'importe quel commit ou branche récents, rendu comme un diff de PR, en
direct pendant que le fichier continue de changer ;
pullmark --diffle fait depuis un terminal — le plus court chemin vers « qu'est-ce que l'agent vient de changer dans ma doc ». - Parcourez sans vous ensevelir — cliquez de fichier en fichier dans un dossier ou un dépôt : chacun s'affiche en aperçu, une seule entrée en italique dans Fichiers ouverts que le clic suivant remplace. Double-cliquez (ou commencez simplement à éditer) pour le garder.
- Le plan en barre latérale — une carte de vos titres, façon navigateur, à un bouton de distance.
- Trouvez tout — ⌘F parcourt les occurrences de la page ; ⇧⌘F cherche d'un coup dans tous les fichiers de la barre latérale.
- Un zoom qui recompose — ⌘+ et ⌘− (ou un pincement) agrandissent ensemble texte, images et colonne de lecture, mémorisés d'un lancement à l'autre ; la navigation grandit avec.
- Cliquez pour inspecter — images, diagrammes Mermaid et formules en bloc s'ouvrent dans une vue dédiée avec panoramique et zoom, pour que les diagrammes complexes ne restent pas coincés à la largeur de colonne — et enregistrez ou partagez exactement ce que vous inspectez (les diagrammes en vrais SVG).
- Emportez-le partout — export en PDF ou en fichier HTML autonome ; ⌘C colle en texte riche dans Docs et Slack, ⌥⌘C restitue le Markdown.
- Trois thèmes de lecture — Editorial, GitHub et Terminal, avec aperçus en direct dans Réglages — ou déposez votre propre CSS. Clair et sombre restylent tout, Mermaid compris, et la longueur de ligne vous appartient : Standard, Wide ou Full Width.
- Les liens GitHub s'ouvrent dans l'app — cliquez un lien
github.comvers un fichier Markdown et PullMark le rend, avec une barre de provenance dépôt @ branche toujours visible ; ⌘-clic l'envoie au navigateur. - Ouvrir rapidement — ⌘K saute vers n'importe quel titre, fichier ou PR, en recherche floue — ou collez l'URL d'une PR, l'URL d'un dépôt ou un chemin de fichier, et il l'ouvre directement.
- Déplacé veut dire déplacé — un paragraphe déplacé à l'identique s'affiche une seule fois, avec une discrète pastille violette, pas du bruit rouge-plus-vert.
- Reprend où vous en étiez — vos fichiers, vos PR et votre position de lecture se restaurent au lancement.
Voilà l'essentiel. La doc couvre le reste —
chaque fonctionnalité, chaque réglage, chaque icône, le plan clavier complet et la
commande pullmark.
Lire par défaut. Éditer sur place.
Appuyez sur ⌘E et la page devient l'éditeur : le bloc sous votre curseur révèle son Markdown brut sur place — même typographie, même position, rien ne saute — et vous tapez immédiatement. Passez de bloc en bloc aux flèches, fusionnez avec Retour arrière, scindez d'une ligne vide ; quitter un bloc l'enregistre par le même chemin protégé et versionné que tout le reste. La lecture reste le mode par défaut ; la frontière entre les modes, c'est le geste d'enregistrer.
GitHub est un lieu où vivent vos docs. Lisez-le comme tel.
Cliquez un lien github.com vers un fichier Markdown :
PullMark le récupère et le rend dans l'app — le premier clic demande le comportement
voulu, et ⌘-clic fait toujours l'inverse. Une barre de provenance au-dessus de
la page dit exactement quel dépôt et quelle branche vous lisez, épinglés au commit
résolu ; les liens relatifs continuent de se résoudre contre le dépôt, toute
l'arborescence Markdown est à un clic dans la barre latérale, et les dépôts privés
utilisent la connexion GitHub que vos PR utilisent déjà — rien de ce qui est récupéré ne
touche jamais le disque. Les branches sont une pastille sur chaque dépôt : changez
sur place, ouvrez une autre branche comme entrée à part dans la barre latérale, ou sautez
dans un worktree local. Et si le dépôt est déjà cloné sur votre Mac sur cette branche, le
lien ouvre votre fichier local à la place.
natif
Une app Mac digne de ce nom.
Une vraie CLI
pullmark README.md, pullmark ~/wt docs/plan.md — fichiers,
dossiers et worktrees s'ouvrent dans l'app en cours, toujours dans la fenêtre au
premier plan. pullmark --help la documente ; la
doc aussi.
App par défaut pour .md
Un clic dans Réglages et le double-clic dans le Finder signifie rendu, partout — et si une mise à jour fait un jour sauter l'association, PullMark s'en aperçoit et propose de la rétablir.
Vos identifiants existants
Pas de connexion à part. PullMark utilise gh auth token ou votre
assistant d'identification git — les dépôts privés et d'organisation fonctionnent,
tout simplement.
Rien ne reste sur le disque
Le contenu de PR récupéré vit dans des sessions éphémères et des caches mémoire bornés — rien de ce qui vient de GitHub n'est écrit en stockage persistant.
Open source, MIT
Swift, zéro dépendance de paquet, et une licence qui ne se met pas en travers. Lisez la source.
Offrez une salle de lecture à vos docs.
Gratuite, open source, signée et notarisée. Un téléchargement suffit.
Homebrew
$ brew tap jedijashwa/tap
$ brew trust jedijashwa/tap
$ brew install --cask pullmark
Téléchargement direct
Télécharger PullMark
Le dernier DMG — ouvrez-le, glissez vers Applications (PullMark se charge du nettoyage). Toutes les versions →
Dans les deux cas, PullMark vérifie les mises à jour et les installe en un clic.