Guía práctica
Editar Markdown de forma visual en Mac
Escribe una nota de proyecto con títulos, una lista de tareas y enlaces en Balise, y consulta el mismo documento en su código Markdown.
Un README, un plan o una nota de reunión debe ser fácil de leer y actualizar. En Balise puedes trabajar sobre el documento con formato en la vista visual y consultar su sintaxis Markdown en la vista de código fuente. Ambas editan el mismo archivo de tu Mac.
1. Empezar con una nota breve
Abre un archivo .md o crea un documento Markdown en Balise. Para este ejemplo, prepara una nota de lanzamiento con un título, una frase sobre el objetivo y dos tareas. Su código puede tener esta forma:
# Lanzamiento del proyecto
Preparar una primera versión para que otros la prueben.
## Comprobaciones
- [ ] Revisar la página de inicio
- [ ] Probar la descarga
## Referencia
[Plan del proyecto](plan.md)
El enlace a plan.md supone que ese archivo existe en la misma carpeta. Puedes sustituirlo por el nombre de una de tus notas.
2. Escribir en la vista visual
Cambia a la vista visual para ver el título, las tareas y el enlace con formato. Edita la frase del objetivo directamente en el documento. Usa los controles de formato para añadir un título, una lista o texto en negrita.
El documento se actualiza mientras escribes: esta vista permite editar, además de leer. También puedes insertar una tabla o una imagen cuando la explicación lo necesite.
3. Consultar el código cuando haga falta
Cambia a la vista de código fuente para revisar los marcadores Markdown o el destino de un enlace. Después vuelve a la vista visual para seguir escribiendo. No necesitas exportar el documento para cambiar de vista.
Si el documento contiene extensiones complejas de Markdown, utiliza la vista de código fuente y revisa el resultado antes de guardar. La edición visual no garantiza que se conserve toda sintaxis extendida.
4. Guardar y reutilizar la nota
Guarda con ⌘S. El resultado sigue siendo un archivo Markdown que puedes abrir de nuevo en Balise o utilizar con las otras herramientas del proyecto. Los archivos y las imágenes enlazados deben seguir disponibles en sus ubicaciones.
Cuando varias notas describen trabajos en curso, puedes organizarlas en un tablero Kanban. Para conocer más comandos, consulta el capítulo Markdown del manual, disponible en francés.