Markdown Buddy › Vista previa Markdown en Xcode
Vista previa Markdown en Xcode
Xcode muestra los archivos Markdown como código fuente sin formato. Para un README, un CHANGELOG o una nota de arquitectura, eso significa leer el marcado en lugar del documento. Markdown Buddy incluye una extensión Source Editor nativa: desde el menú Editor, el archivo que estás viendo se abre renderizado, sin salir de tu proyecto.
Instalar la extensión
- Instala Markdown Buddy desde el Mac App Store y ábrelo una vez, para que macOS registre la extensión que lleva.
- Abre Ajustes del Sistema, ve a General y luego a Arranque y extensiones, y activa Markdown Buddy bajo Xcode Source Editor.
- Reinicia Xcode. Las extensiones se leen al arrancar, así que un Xcode ya abierto no verá la que acabas de activar.
- Abre un archivo .md y usa Editor y luego Markdown Buddy. Puedes asignarle un atajo de teclado en los ajustes de Xcode, apartado Key Bindings.
Por qué importa en un repositorio
La documentación de un proyecto vive junto al código, y es precisamente el editor de código quien peor la muestra:
- Un README con tablas y distintivos es ilegible como código fuente
- Un CHANGELOG es una larga lista anidada, donde la sangría lleva el significado
- Una nota de arquitectura suele contener diagramas Mermaid, que Xcode muestra como texto delimitado
- Los enlaces relativos entre documentos no se pueden seguir desde la vista de código
Más allá de la extensión
La misma app abre una carpeta entera como espacio de trabajo, busca en todos sus archivos .md y dibuja el grafo de enlaces entre tus documentos señalando los rotos. En un repositorio cuya documentación ha crecido, eso suele ser más útil que la propia vista previa.
Si el comando no aparece en el menú Editor
- Comprueba que la extensión está activada en Ajustes del Sistema, apartado General, Arranque y extensiones, sección Xcode Source Editor.
- Cierra Xcode por completo y vuelve a abrirlo. La lista de extensiones solo se lee al iniciar.
- Abre Markdown Buddy una vez desde la carpeta Aplicaciones y vuelve a intentarlo.
- El comando solo aparece si el documento en primer plano es un archivo Markdown. En un archivo .swift permanece oculto.
Preguntas frecuentes
¿Modifica mi proyecto?
No. La extensión se limita a leer el documento abierto en el editor y a mostrarlo renderizado. No se escribe nada en tu proyecto.
¿Qué versiones de Xcode funcionan?
Todas las versiones de Xcode compatibles con las extensiones Source Editor, en macOS 14.0 y posteriores.
¿Puedo asignarle un atajo de teclado?
Sí, en los ajustes de Xcode, apartado Key Bindings, buscando el nombre de la extensión. Del atajo se encarga Xcode, no la extensión.
¿Funciona con cualquier archivo Markdown o solo con README.md?
Con cualquier archivo Markdown abierto en el editor, sea cual sea su nombre.
Deja de leer tu documentación como código fuente
Markdown Buddy es una compra única de 5,99 €, sin suscripción ni compras dentro de la app.
Descargar en el Mac App Store