## Flujo de trabajo para desarrolladores
Cómo previsualizar README.md de GitHub localmente en Mac
Publicado en marzo de 2026
Editaste el README. Ahora quieres ver cómo se ve antes de hacer push. Aquí tienes tres formas de hacerlo, de la más pesada a la instantánea.
## Por qué previsualizar localmente
¿Por qué previsualizar localmente?
- Verificar formato antes de hacer push. Tablas rotas, enlaces rotos y bloques de código mal formados son vergonzosos en un repo público. Captúralos antes de
git push. - Trabajar sin conexión. Aviones, trenes, cafeterías con wifi malo. Tu README no debería necesitar conexión a internet para revisarlo.
- Revisar cambios de documentación en PRs. Cuando un pull request actualiza el README, quieres ver el resultado renderizado junto al diff del código.
- Evitar el ciclo commit-push-verificar. Hacer push de un commit solo para ver cómo se renderiza tu README en GitHub contamina tu historial de git y pierde tiempo.
## Método 1
grip (herramienta CLI)
pip install grip grip README.md
grip renderiza tu Markdown usando la API de GitHub, así que obtienes renderizado idéntico al de GitHub en tu navegador en localhost:6419.
Ventajas
- Renderizado exacto de GitHub (usa su API)
Desventajas
- Requiere Python instalado
- Necesita token de API de GitHub para uso intensivo (limitado sin él)
- Ejecuta un servidor local que debes iniciar y detener
- No funciona sin conexión (llama a la API de GitHub)
## Método 2
Vista previa integrada de VS Code
Abrir README.md en VS Code Cmd + Shift + V → panel de vista previa
VS Code tiene una vista previa de Markdown integrada. Abre el archivo, usa el atajo de teclado y un panel lateral muestra la salida renderizada.
Ventajas
- Ya instalado para la mayoría de desarrolladores
- Funciona sin conexión
Desventajas
- Abrir un IDE completo para previsualizar un README es excesivo
- El renderizado no coincide exactamente con GitHub (sin soporte de llamadas, diferente estilo de tablas)
- Atado a tu editor — no puedes simplemente hacer doble clic en un archivo
## Método 3 (Recomendado)
ShowMeMyMD — solo haz doble clic
git clone <repo> Doble clic en README.md Listo.
ShowMeMyMD es un visor de Markdown nativo para macOS. Configúralo como tu app predeterminada para archivos .md y cada README se abre como vista previa renderizada al instante. Sin CLI. Sin servidor. Sin configuración.
Soporte completo de GitHub-Flavored Markdown:
- Tablas con alineación
- Listas de tareas con casillas
- Bloques de código con resaltado de sintaxis
- Llamadas estilo GitHub:
NOTE,TIP,WARNING,IMPORTANT,CAUTION
Clonar, doble clic en README.md, listo.
## Comparación
Comparación lado a lado
| Herramienta | Configuración | Precisión GFM | Velocidad | Sin conexión |
|---|---|---|---|---|
| grip | Python + pip install | Exacta (API de GitHub) | Lenta (red) | No |
| VS Code | Ya instalado | Parcial | Rápida | Sí |
| ShowMeMyMD | Instalar una vez desde Mac App Store | GFM completo + llamadas | Instantánea | Sí |
## Sigue leyendo
Descubre más sobre ShowMeMyMD como visor de Markdown para Mac. Mira cómo encaja en un flujo de trabajo de desarrollador. O lee nuestra guía de llamadas estilo GitHub.
Deja de hacer push para verificar tu README
Haz doble clic en cualquier archivo .md y visualízalo renderizado al instante. GitHub-Flavored Markdown, resaltado de sintaxis, cuatro temas. $2.99 en la Mac App Store.