Quick Look
Pulsa espacio sobre cualquier archivo Markdown en el Finder y míralo renderizado con tu tema de lectura, antes de abrir app alguna.
tu agente
Tu agente escribe planes.
Revísalos como los de un colega.
Los agentes producen mucho Markdown: planes de implementación, especificaciones, informes de investigación — documentos largos que necesitan tu criterio antes de que nadie actúe sobre ellos. Las formas de dárselo que ya existen no sirven para la tarea. El código fuente crudo en un editor esconde lo que vería un lector, pegar fragmentos en un chat separa el comentario del lugar al que se refiere, y hacer commit de un borrador de trabajo solo para conseguir los cuadros de comentarios de un PR es puro ceremonial — no todo documento merece un pull request.
Las notas al margen ponen el comentario en el propio documento. Lee el borrador renderizado, haz clic donde algo falla y deja una nota firmada, anclada a ese bloque. Las notas son simples comentarios HTML que no aparecen en la página renderizada — así que «atiende mis notas en el plan» es todo el traspaso: tu agente lee cada nota exactamente donde la dejaste. Sin commit, sin pegar nada, sin pull request. Después mira aterrizar la revisión — Comparar resalta los cambios del agente palabra por palabra, en vivo a medida que guarda.
Todo el ciclo — incluidas las instrucciones para entregarle a tu agente — está desarrollado en la página de agentes. Las notas al margen están en beta y activadas por defecto; los docs explican la mecánica.
por qué
La prosa no es código.
Deja de revisarla como si lo fuera.
Conoces el momento: un muro verde de cuarenta líneas en el diff de un README y, en algún punto de dentro, la única frase que de verdad cambió. Documentos de diseño, registros de decisiones, runbooks, definiciones de agentes — cada semana pasa más prosa por tu cola de revisión, y un diff del código fuente de la prosa esconde justo lo que viniste a juzgar.
PullMark te muestra el cambio tal como lo encontrarán los lectores: renderizado, con solo las palabras que cambiaron resaltadas. Las tablas siguen siendo tablas, los diagramas siguen siendo diagramas, y una edición de una palabra es una palabra resaltada. Comenta cualquier bloque y el comentario cae en las líneas exactas que GitHub espera — aprueba, solicita cambios o deja sugerencias que el autor aplica con un clic.
«La sala de lectura junto al taller.»
Nota
PullMark no es un cliente de revisión completo, y es a propósito. Muestra solo los archivos Markdown de un PR — para las partes de código de un cambio, tus herramientas de revisión de siempre siguen siendo el lugar adecuado.
revisar
Toda la revisión de docs, desde la página renderizada.
Alterna entre la disposición en línea y lado a lado, baja al Diff del código fuente o previsualiza el Resultado final — todo desde la barra de herramientas, que además te lleva de archivo en archivo y de vuelta al PR sin tocar la barra lateral. El front matter YAML se renderiza como una tabla de metadatos discreta, no como un muro de prosa en negrita — así los docs cargados de configuración también se comparan con limpieza. Un documento nuevo se lee como un documento — una sola nota avisa de que todo es nuevo, en lugar de teñir de verde cada bloque. Los hilos de revisión existentes aparecen bajo los bloques que discuten. Pasa el cursor por cualquier bloque, haz clic en el globo y comenta el bloque entero o exactamente las líneas que elijas. Al terminar, Aprobar, Solicitar cambios o Comentar directamente desde el resumen — con o sin comentarios de línea — y deja también comentarios a nivel de archivo o de simple conversación. El resumen muestra en qué punto está el PR: aprobado o con cambios solicitados, el veredicto de cada revisor, los checks de CI con acceso directo a los logs de cada check y la conversación completa como una cronología legible. Los PR abiertos se comprueban cada minuto; si la rama avanza, un clic actualiza y tus borradores sobreviven.
Iniciar una revisión
La opción por defecto: acumula borradores en local. Envíalos juntos — Comentar, Aprobar o Solicitar cambios — o guarda una revisión pendiente para terminarla en github.com.
Añadir un solo comentario
Publica un único comentario de revisión al instante, anclado al bloque — o acotado a solo las líneas que selecciones en el editor.
Añadir una sugerencia
El lápiz abre el código Markdown del bloque en un editor — tu cambio se publica
como un bloque ```suggestion que el autor aplica con un clic.
leer
Un lector de verdad para el Markdown que ya vive en tu disco.
Tus notas, tus README, la carpeta de docs de tu equipo — abre un archivo o un directorio entero y léelo con el aspecto para el que se escribió. Todo se vuelve a renderizar en cuanto cambia en disco, las imágenes y enlaces relativos simplemente se resuelven y, si GitHub lo renderiza, PullMark lo renderiza:
Negrita, cursiva, tachado, código en línea,
resaltado, H2O, mc2,
eiπ + 1 = 0,
enlaces con vista previa al pasar el cursor, notas al pie[1],
listas de tareas — además de tablas, diagramas Mermaid,
código con resaltado de sintaxis, alertas > [!NOTE], fórmulas KaTeX sin conexión,
[toc] y front matter YAML plegado en una ordenada tabla de metadatos.
- La historia en el margen — un margen de blame discreto: un avatar por grupo de bloques; pasa el cursor para ver autor, fecha y commit; haz clic para el historial completo de la línea.
- Siempre al día — guarda desde cualquier editor y la página ya se habrá vuelto a renderizar.
- Diff contra el historial — un clic compara el archivo de trabajo con
cualquier commit o rama reciente, renderizado como el diff de un PR, en vivo mientras
el archivo sigue cambiando;
pullmark --difflo hace desde una terminal — la vía más rápida al «qué acaba de cambiar el agente en mi doc». - Navega sin enterrarte — recorre con un clic una carpeta o un repo y cada archivo se muestra como vista previa: una sola entrada en cursiva en Archivos abiertos que el siguiente clic reemplaza. Doble clic (o empieza a editar) para conservarla.
- Barra lateral de esquema — un mapa de tus encabezados al estilo de un navegador de código, a un interruptor de distancia.
- Encuentra lo que sea — ⌘F recorre las coincidencias de la página; ⇧⌘F busca a la vez en todos los archivos de la barra lateral.
- Zoom que reajusta el texto — ⌘+ y ⌘− (o un pellizco) escalan juntos el texto, las imágenes y la columna de lectura, y se recuerdan entre sesiones; la navegación crece con ellos.
- Clic para inspeccionar — las imágenes, los diagramas Mermaid y las fórmulas en bloque se abren en una vista superpuesta con desplazamiento y zoom, para que los diagramas complejos no queden atrapados en el ancho de la columna — y guarda o comparte exactamente lo que estás inspeccionando (los diagramas, como SVG de verdad).
- Llévalo a donde sea — exporta como PDF o como un único archivo HTML autocontenido; ⌘C pega con formato en Docs y Slack, ⌥⌘C devuelve el Markdown.
- Tres temas de lectura — Editorial, GitHub y Terminal, con vistas previas en vivo en Ajustes — o añade tu propio CSS. Claro y oscuro lo reestilizan todo, Mermaid incluido, y el largo de línea es tuyo: Standard, Wide o Full Width.
- Los enlaces de GitHub se abren en la app — haz clic en un enlace de
github.coma un archivo Markdown y PullMark lo renderiza, con una barra de procedencia siempre visible con repo @ rama; con ⌘-clic lo mandas al navegador. - Apertura rápida — ⌘K salta a cualquier encabezado, archivo o PR, con búsqueda difusa — o pega la URL de un PR, la URL de un repo o una ruta de archivo y lo abre directamente.
- Movido significa movido — un párrafo reubicado sin cambios se renderiza una sola vez con un discreto chip violeta, no como ruido rojo y verde.
- Retoma donde lo dejaste — tus archivos, tus PR y tu posición de lectura se restauran al abrir.
Esos son los momentos estelares. Los docs cubren el
resto — cada función, cada ajuste, cada icono, el mapa de teclado completo y el comando
pullmark.
Leer por defecto. Editar en el sitio.
Pulsa ⌘E y la página se convierte en el editor: el bloque bajo tu cursor revela su Markdown crudo en el sitio — misma tipografía, misma posición, nada salta — y ya estás escribiendo. Muévete entre bloques con las flechas, fusiona con retroceso, divide con una línea en blanco; al salir de un bloque se guarda por la misma vía protegida y versionada que todo lo demás. Leer sigue siendo el modo por defecto; la frontera entre modos es el gesto de guardar.
GitHub es un lugar donde viven tus docs. Léelo como tal.
Haz clic en un enlace de github.com a un archivo Markdown y
PullMark lo descarga y lo renderiza en la app — el primer clic te pregunta qué comportamiento
prefieres, y ⌘-clic siempre hace lo contrario. Una barra de procedencia sobre la
página dice exactamente qué repo y qué rama estás leyendo, fijada al commit al que se
resolvió; los enlaces relativos siguen resolviéndose contra el repo, el árbol Markdown
completo queda a un clic en la barra lateral y los repos privados usan la sesión de GitHub
que ya usan tus PR — nada de lo descargado toca el disco. Las ramas son un chip en cada
repo: cambia en el sitio, abre otra rama como su propia entrada en la barra lateral o salta
a un worktree local. Y si el repo ya está clonado en tu Mac en esa rama, el enlace abre tu
archivo local.
nativa
Una app de Mac que se comporta como tal.
Una CLI de verdad
pullmark README.md, pullmark ~/wt docs/plan.md — archivos,
carpetas y worktrees se abren en la app en ejecución, siempre en la ventana frontal.
pullmark --help lo documenta; los docs también.
La app por defecto para .md
Un clic en Ajustes hace que doble clic en el Finder signifique renderizado, en todas partes — y si una actualización rompe alguna vez el vínculo, PullMark lo nota y te lo ofrece de vuelta.
Tus credenciales de siempre
Sin inicio de sesión aparte. PullMark usa gh auth token o el credential
helper de tu git — los repos privados y de organización simplemente funcionan.
Nada queda en disco
El contenido de PR descargado vive en sesiones efímeras y cachés de memoria acotadas — nada de GitHub se escribe en almacenamiento persistente.
Código abierto, MIT
Swift, cero dependencias de paquetes y una licencia que no se interpone en tu camino. Lee el código fuente.
Dale a tus docs una sala de lectura.
Gratis, de código abierto, firmada y notarizada. A una descarga de distancia.
Homebrew
$ brew tap jedijashwa/tap
$ brew trust jedijashwa/tap
$ brew install --cask pullmark
Descarga directa
Descargar PullMark
El DMG más reciente — ábrelo y arrástralo a Aplicaciones (PullMark se encarga de la limpieza). Todas las versiones →
Vayas por donde vayas, PullMark busca actualizaciones y las instala con un clic.