El espacio Markdown sirve para los archivos de texto de un proyecto: README, planes, especificaciones, decisiones, prompts, diarios y AGENTS.md. Lo que guarda sigue siendo Markdown, legible por Git, sus scripts y las herramientas de otras personas.
Dos formas de editar el mismo archivo
Un selector alterna entre Visual y Fuente. También puede elegir Vista > Alternar entre Fuente y Visual (⇧⌘E).
Visual muestra la jerarquía, los estilos, las tablas, las imágenes, las casillas, las ecuaciones y los diagramas. Fuente muestra el Markdown literal, presentado como código.
Ambos modifican el mismo documento. Puede cambiar de uno a otro en mitad de una frase.
El modo Visual es un editor: Balise vuelve a convertir sus cambios en Markdown. Balise nunca guarda HTML en lugar del archivo fuente.
Elegir la tipografía del modo Visual
Ajustes > Markdown ofrece tres presentaciones globales: Tema Mac predeterminado, New York para una lectura editorial espaciosa y GitHub para un ritmo más compacto.
El cambio se aplica inmediatamente a las ventanas abiertas y conserva el cursor, la selección, el desplazamiento y el historial de deshacer. Solo cambian la tipografía, el ancho de lectura y los espacios; los colores siguen siendo los de macOS y respetan automáticamente el aspecto claro u oscuro.
La presentación no pertenece al documento. El Markdown literal, el modo Fuente, la impresión, la exportación y la copia enriquecida siguen iguales.
Exportar un documento
Archivo > Exportar… prepara una copia del contenido actual, incluidos los cambios sin guardar. Balise captura el contenido al abrir el panel; la exportación no guarda el archivo Markdown.
Elija HTML autónomo, HTML sin tema, PDF o Documento Word (DOCX). Los estilos de publicación Estándar, Editorial y Compacto son independientes del tema del editor. El PDF ofrece papel A4 o Carta, orientación, márgenes, encabezado, pie y números de página. Los títulos se convierten en marcadores y los enlaces internos permiten navegar por el PDF.
El HTML autónomo incluye las imágenes locales accesibles y los recursos necesarios para representar el contenido. Los diagramas quedan fijados como SVG. El HTML sin tema conserva las fórmulas en MathML, sin una hoja de estilo de Balise. Las salidas despliegan las secciones plegables.
Una imagen local ausente, inaccesible o demasiado grande impide exportar; el mensaje indica el recurso afectado. Las imágenes remotas siguen siendo referencias en línea en el HTML y Balise no las descarga para el PDF. El panel anuncia esta limitación cuando las encuentra. Corrija una representación técnica incompleta antes de publicar.
Para exportar una nueva versión del documento, abra Archivo > Exportar… y elija formato y destino. La exportación utiliza el contenido actual.
El DOCX conserva títulos, párrafos, listas, tablas y notas editables. Las fórmulas y los diagramas se convierten en imágenes de la representación anunciada en el panel. Conservan su aspecto y numeración, pero no se convierten en objetos LaTeX o Mermaid editables en Word. Las imágenes remotas aparecen mediante su texto alternativo y su enlace. El DOCX utiliza una presentación de Word sobria, independiente de los estilos HTML/PDF.
Enviar a Slack
El destino Slack está disponible en Archivo > Exportar…. Conecte su espacio de trabajo para enviar una copia del documento a un canal.
- Abra Archivo > Exportar… y elija Slack.
- Pulse Conectar Slack y autorice Balise en el espacio de trabajo de Slack que quiera utilizar desde el navegador.
- Elija un Canal público o privado al que pertenezca.
- Pulse Enviar a Slack para publicar con su identidad de Slack.
El mensaje contiene una copia del contenido capturado al abrir el panel, incluidos los cambios sin guardar. El envío no modifica ni guarda su archivo Markdown. Tras la confirmación, Abrir el mensaje en Slack permite consultar el resultado. Slack aplica su propia presentación al Markdown; los diagramas Mermaid y las fórmulas de Balise no conservan allí su representación.
Sustituya los enlaces y las imágenes que apuntan a archivos de su Mac por direcciones web accesibles para los destinatarios. Si Balise indica que el contenido es demasiado largo, prepare un fragmento más corto; el texto no se recorta automáticamente. Si el resultado del envío es incierto, compruebe el canal en Slack antes de volver a intentarlo para evitar un duplicado.
Desconectar en este Mac elimina la conexión guardada en este Mac. Para publicar desde otra cuenta, vuelva a conectarse y elija de nuevo el canal.
Escribir un documento largo
Vista > Concentración atenúa los párrafos vecinos y mantiene legible el pasaje activo. Vista > Máquina de escribir centra de nuevo el cursor mientras escribe. Los dos modos son independientes, están disponibles en Fuente y Visual y se recuerdan para las ventanas Markdown. Desplazarse manualmente suspende el centrado hasta que vuelva a escribir. Estos modos no modifican el archivo ni su exportación.
El contador al pie del documento muestra las palabras del documento o de la selección. Haga clic para ver los caracteres, los caracteres sin espacios, las líneas fuente y una estimación de lectura a 200 palabras por minuto. El contador mide la prosa: títulos, listas, celdas, leyendas y notas contadas una vez. Excluye el código, los metadatos y los destinos de los enlaces. Los caracteres son grafemas Unicode; los apóstrofos y guiones internos unen una palabra. La estimación es menos precisa en los idiomas que no separan las palabras con espacios. Balise muestra las limitaciones de los documentos grandes.
Aplicar formato
El menú Formato y el inspector aplican las estructuras habituales: párrafos y títulos de niveles 1 a 6, negrita, cursiva, tachado, código en línea, enlaces, listas con viñetas, listas numeradas, tareas con casillas, citas, bloques de código, tablas e imágenes.
Puede aumentar o reducir el nivel de una lista. Las tareas vacías y las sublistas se conservan al guardar y volver a abrir. Las casillas pegadas se pueden marcar directamente en Visual. Cuando el cursor está en una tabla, el inspector muestra su número de filas y columnas y permite añadirlas o retirarlas sin reconstruir el resto del documento.
Consulte Atajos de teclado.
Resaltar, subrayar, aplicar superíndice o subíndice
Formato > Resaltar, Subrayado, Superíndice y Subíndice actúan sobre la selección en Visual y Fuente. También están en Más estilos de texto, debajo de las acciones de Texto del inspector. No añaden atajos de teclado.
Un segundo clic retira el estilo de la selección. El superíndice y el subíndice se sustituyen mutuamente en la parte elegida. Sin selección, la orden inserta text y lo selecciona para que lo reemplace al escribir. La escritura posterior mantiene su historial habitual; insertar el estilo sigue siendo un paso de deshacer separado.
El archivo conserva las etiquetas <mark>, <u>, <sup> y <sub>. Los atributos HTML y CSS importados no forman parte de estos estilos. Las órdenes no están disponibles en código, ecuaciones ni documentos de solo lectura.
Insertar un enlace, una tabla o un bloque de código
El menú Insertar también ofrece Añadir enlace…, Tabla y Bloque de código, en Visual y Fuente. Estos accesos utilizan las mismas órdenes que Formato y el inspector. El enlace toma la selección actual; Bloque de código mantiene su comportamiento de alternancia.
El menú agrupa el enlace y las notas al pie, después las tablas, los bloques de código y las líneas horizontales, y después las imágenes, las ecuaciones y los diagramas Mermaid. Estas órdenes están desactivadas fuera de un documento Markdown editable.
Formato > Añadir enlace… conserva el atajo ⌘K. Los nuevos accesos de Insertar no añaden atajos.
Insertar un índice
Insertar > Índice… crea una lista Markdown de enlaces a los títulos. Elija los niveles H1 a H6 y, si lo necesita, excluya el primer H1. La vista previa muestra la lista antes de aplicarla. Sin títulos admisibles, Aplicar permanece desactivado.
Sin selección, la lista se inserta en el cursor. Con una selección, el panel muestra el texto que se reemplazará. Para actualizar un índice, seleccione expresamente su lista y vuelva a utilizar Insertar > Índice…. Balise no reconoce ni reescribe automáticamente una lista existente.
Los enlaces distinguen los títulos repetidos. No se proponen títulos del código, los metadatos ni las citas; se incluyen los títulos Setext. Las anclas generadas usan el texto del título en minúsculas, sin acentos, con un sufijo para los duplicados; los títulos sin caracteres admisibles utilizan section. Después de cambiar el nombre de un título, actualice expresamente el índice. Otros lectores Markdown pueden utilizar una convención de anclas diferente.
El índice permanece como una lista editable en el archivo, sin requerir un índice local. Cada aplicación se deshace en un paso.
Para encontrar el índice sin seleccionar su lista, marque Permitir actualizar este índice más adelante al insertarlo. Dos comentarios en el archivo delimitan su zona. Insertar > Actualizar el índice… presenta la lista anterior, las entradas añadidas, retiradas o modificadas y el resultado propuesto. Elija los niveles, revise las dos versiones y aplique.
Balise nunca actualiza el índice al abrir o guardar. Solo se admite una zona completa: los marcadores ausentes, múltiples o mal cerrados bloquean la actualización. El texto sigue accesible en Fuente. Una lista manual nunca se convierte automáticamente en una zona gestionada. Las listas ordinarias se pueden seguir reemplazando después de seleccionarlas expresamente.
Secciones plegables
Insertar > Sección plegable… pide un título sencillo y contenido Markdown. Sin selección, la sección se crea en el cursor; con una selección, el panel toma su texto como contenido. El archivo conserva las etiquetas HTML details y summary.
La flecha abre y cierra la sección sin modificar el archivo. Para editarla, abra la sección y elija Editar…. La opción Abierta por defecto cambia el atributo open guardado. El título, el contenido y la opción se aplican juntos en una acción que se puede deshacer. Quitar el plegado conserva el título como párrafo y el contenido; Eliminar la sección retira el bloque entero.
Las listas y los bloques de código ordinarios aparecen en el cuerpo; se editan mediante el panel. Los diagramas y las ecuaciones internos no reciben una representación especializada. Las secciones anidadas, mal cerradas o con un título HTML complejo permanecen como texto protegido que se edita en Fuente. Los atributos desconocidos se conservan en el archivo sin ejecutarse en la representación.
La búsqueda abre temporalmente la sección que contiene un resultado. La impresión y la exportación HTML despliegan las secciones para incluir su contenido. Vista Rápida también las muestra desplegadas, sin flecha interactiva; utilice Balise para plegarlas.
Recuadros
Insertar > Recuadro ofrece Nota, Consejo, Importante, Advertencia y Precaución. Los marcadores del archivo siguen siendo NOTE, TIP, IMPORTANT, WARNING y CAUTION, dentro de una cita Markdown. Un lector que no reconoce esta convención puede mostrar una cita ordinaria con el marcador.
En modo Visual, el título automático de cada recuadro sigue el idioma elegido en Balise, aunque macOS use otro idioma. Por ejemplo, el marcador TIP muestra «Consejo» en español, «Tip» en inglés y «Astuce» en francés. Cambiar este idioma no traduce su texto ni modifica los marcadores del archivo.
Con una selección, Balise envuelve los párrafos afectados en el recuadro. Sin selección, lo crea en el cursor; en Visual, se abre su panel de contenido para escribir el texto. La creación y la aplicación del contenido son dos acciones distintas en el historial.
En Documento > Recuadros, Tipo de recuadro cambia solo el marcador. Editar recuadro… edita el contenido Markdown, incluidos párrafos, listas, enlaces y bloques de código. Convertir en cita retira el marcador y conserva el cuerpo citado. Una cita ordinaria puede recibir un tipo desde este mismo inspector. El panel de contenido también ofrece Convertir en texto sin formato. Estas acciones se deshacen individualmente.
El bloque está protegido durante una edición visual vecina. Los marcadores desconocidos, los títulos personalizados y los recuadros anidados importados no se normalizan; se modifican en Fuente. Un icono y una etiqueta acompañan el color del tipo.
Notas al pie
Insertar > Nota al pie… ofrece un identificador libre y un editor de contenido, en Fuente y Visual. La referencia se añade después del texto seleccionado y conserva ese texto. Cancelar cierra el editor sin cambiar el documento.
En Visual, una referencia abre el editor de su nota. Puede modificar el contenido, renombrar el identificador con una vista previa de las apariciones afectadas o eliminar la nota y sus referencias después de revisarlas. Eliminar una sola referencia conserva la definición. Cada acción se deshace en un paso.
Ir a la definición selecciona su fuente. Volver a la referencia, en el inspector Documento, encuentra la referencia consultada. Una referencia enfocada se abre con Intro; el enlace de retorno de la nota devuelve el foco a su referencia.
El inspector Documento presenta los identificadores, el número de referencias y los estados ausente, sin referencia o duplicado. Las definiciones ausentes o duplicadas se corrigen en Fuente; Balise no elige una de ellas por usted.
Copiar una referencia incluye su definición aunque esté fuera de la selección. Si al pegar encuentra un identificador ya utilizado con un contenido distinto, Balise propone crear un identificador libre, utilizar la nota del destino o cancelar. Nunca sobrescribe la nota del destino; no permite elegir un destino duplicado.
Las definiciones de varias líneas y sus referencias están protegidas durante una edición visual vecina. Las referencias dentro del código y los marcadores escapados no se interpretan. Las referencias contenidas en una definición permanecen literales; no hay interpretación recursiva ni renumeración automática.
Utilizar atajos al escribir
En Visual, Balise reconoce determinados marcadores cuando están solos al principio de un párrafo nuevo. Escriba después un espacio ordinario para crear la estructura: de # a ###### para títulos, - , * , + o • para viñetas, 1. para una lista numerada y - [ ] o - [x] para una tarea.
La transformación conserva el cursor donde está escribiendo. El marcador, el formato y el texto escrito sin pausa se deshacen juntos. En la fuente, las variantes de viñeta se guardan con la forma canónica - y las listas numeradas empiezan por 1..
La sintaxis debe ser explícita: ## crea un título de nivel 2, mientras que ##Título permanece como un párrafo literal. Un marcador precedido de \ nunca se transforma. Los atajos no se aplican al pegado, las selecciones, las tablas, las citas, los bloques de código ni otros bloques técnicos.
Ajustes > Markdown > Atajos de formato al escribir desactiva o reactiva inmediatamente esta ayuda en todas las ventanas. Cuando está desactivada, los párrafos literales se conservan como tales en la próxima carga; Balise añade el escape Markdown en la fuente si hace falta.
Aplicar sangría con Tab
En Visual, coloque el cursor en un elemento de lista y use Formato > Aumentar nivel (Tab) para convertirlo en un subelemento del anterior. El primer elemento del nivel principal no puede bajar de nivel porque no tiene ningún elemento anterior. Use Formato > Disminuir nivel (Mayús-Tab) para subir un subelemento un nivel. Seleccione varios elementos de lista para cambiar su nivel a la vez.
Para cambiar los espacios al principio de un párrafo normal, pase a Fuente. Coloque el cursor antes del texto de una línea y pulse Tab para añadir dos espacios al principio de esa línea. Seleccione varias líneas para aplicarles sangría a la vez. Mayús-Tab quita un nivel: una tabulación o hasta dos espacios. Cada cambio de sangría en Fuente se deshace en una acción.
Insertar una imagen
Insertar una imagen abre un selector de macOS. Si el documento todavía no se ha guardado, Balise pregunta primero dónde colocarlo.
La imagen elegida se copia en una carpeta de recursos asociada al documento y Balise inserta un enlace relativo en el Markdown. Así puede mover el documento junto con sus imágenes.
Pegar y organizar capturas
Pegar acepta una sola imagen bitmap del portapapeles en Fuente y Visual. Balise guarda la captura en Nombre.assets junto al documento; un borrador conserva sus imágenes hasta su primer guardado. El pegado textual o enriquecido sigue tratándose como texto. Una imagen de más de 20 MiB o 40 millones de píxeles se rechaza con un diagnóstico.
Herramientas > Imágenes del documento… enumera las referencias, muestra las imágenes locales y distingue los recursos ausentes, remotos o inaccesibles. Elija una carpeta y revise las copias propuestas antes de agrupar las imágenes. Los nombres repetidos reciben un nombre distinto. Los originales se conservan; deshacer restaura las referencias Markdown. La carpeta elegida puede convertirse en una preferencia para el documento o su espacio de trabajo. Si deja de estar accesible, el pegado anuncia que utilizará Nombre.assets.
Mover los originales a la Papelera es una opción explícita, reservada a recursos cuyo uso exclusivo se ha verificado. Los recursos compartidos o inciertos siguen copiándose. Después de moverlos, Deshacer puede restaurar los originales mientras el documento permanezca abierto en la sesión actual. Las copias agrupadas permanecen; cerrar el documento termina ese historial de deshacer.
Guardar como copia las imágenes locales accesibles en la carpeta de recursos del documento nuevo y ajusta sus enlaces. El archivo anterior y sus imágenes permanecen intactos. Resuelva una imagen local ausente o inaccesible antes de crear esta copia transportable.
Reorganizar una tabla Markdown
En una celda, el menú contextual y el inspector ofrecen mover la fila de datos hacia arriba o abajo, o la columna a izquierda o derecha. El encabezado permanece en su sitio y la alineación sigue a su columna. Los tiradores también permiten arrastrar. Cada movimiento se deshace en una acción.
Dimensiones de la tabla… muestra las celdas no vacías que se retirarán antes de reducir la tabla. La alineación izquierda, centrada o derecha modifica solo el separador Markdown de la columna. El contenido y los finales de línea fuera de la tabla se conservan. Una estructura ambigua se modifica en Fuente.
Completar la información del documento
El inspector Documento ofrece cuatro campos: título, fecha, estado y etiquetas. Puede completarlos sin conocer YAML; Balise crea el front matter si el documento aún no lo contiene.
Los demás metadatos permanecen intactos. Si un campo utiliza una estructura compleja o aparece varias veces, Balise lo lleva a Fuente en lugar de simplificarlo.
Contenido técnico
Balise representa localmente los bloques de código con coloración de sintaxis, las ecuaciones en línea y en bloque, los diagramas Mermaid y los bloques delimitados math, latex o tex. Reconoce las sintaxis $…$, $$…$$, \(…\), \[…\] y entornos de presentación AMS como align, equation, gather o multline. La extensión KaTeX mhchem también representa las fórmulas químicas \ce{…} y \pu{…}.
Configurar los bloques de código y las matemáticas
Los bloques de código tienen un editor técnico con elección de lenguaje, sangría de dos o cuatro espacios o tabulación, números de línea, ajuste de línea y copia. El lenguaje predeterminado puede seguir la última elección. Estos ajustes son globales y no reescriben los bloques existentes. Cambiar el lenguaje de un bloque conserva sus delimitadores, sus atributos y su cuerpo en una única operación que se puede deshacer. Una info string ambigua sigue siendo editable en Fuente.
La representación matemática local resuelve \label, \ref y \eqref en el orden del documento. La numeración se puede desactivar, limitar a entornos AMS o aplicar a todas las ecuaciones en bloque. Un \tag manual tiene prioridad; los entornos con asterisco, \notag y \nonumber no reciben un número automático. Un entorno de varias líneas representa una sola ecuación y recibe como máximo un número o etiqueta. No se admiten numeración ni referencias distintas por línea de un mismo align; separa las ecuaciones en bloques para obtener identidades navegables diferentes. Balise señala las etiquetas ausentes, duplicadas o asociadas a una ecuación sin numerar.
Balise comprende localmente este subconjunto de physics: \qty, \abs, \norm, \dv, \pdv, \bra, \ket y \braket. No carga el paquete LaTeX completo. Las macros definidas por el documento tienen prioridad y los límites de expansión y tamaño de KaTeX siguen aplicándose. La preferencia de numeración se fija al iniciar una exportación para que HTML y PDF mantengan el mismo significado que la vista previa anunciada.
Vista Rápida se ejecuta en un proceso aislado que no comparte las preferencias de Balise, por lo que siempre utiliza la convención AMS. La elección «todas las ecuaciones» no se transmite a Finder.
Las macros globales definidas con \gdef siguen disponibles en las fórmulas posteriores del mismo documento. Cuando encuentra una orden de un paquete LaTeX no admitido, Balise conserva una representación parcial anotada en lugar de ocultar toda la fórmula.
Puede modificar un bloque técnico seleccionado en un editor dedicado, copiarlo como fuente o eliminarlo.
Ver una vista previa en Finder
Seleccione un archivo .md o .markdown en Finder y pulse la barra espaciadora. La extensión de Balise utiliza la representación clara u oscura de la aplicación, incluidas tablas, ecuaciones KaTeX y diagramas Mermaid, sin conexión de red.
Finder transmite solo el archivo seleccionado a la extensión protegida por el aislamiento de macOS. Por eso puede representarse una imagen codificada dentro del documento, pero una imagen vecina enlazada con una ruta relativa puede quedar inaccesible en Vista Rápida; abra el documento en Balise para ver todos sus recursos locales. Los archivos de más de 2 MB, o con un número excepcional de bloques técnicos, muestran también un mensaje que invita a abrirlos en Balise para mantener la respuesta de Vista Rápida.
Navegar por un espacio de trabajo
Abrir una carpeta activa un espacio de trabajo. La navegación izquierda ofrece entonces dos vistas.
- Archivos, con carpetas que puede desplegar o plegar al hacer clic en su fila. Su menú contextual permite mostrarlas en Finder o copiar su ruta. El filtro busca recursivamente archivos y carpetas; la ruta del documento activo se despliega automáticamente. Puede abrir un archivo en la pestaña actual, una pestaña nueva o una ventana nueva;
- Esquema, construido a partir de los títulos y sus niveles.
Los archivos de tablero .balisekanban, .balisekanban y, cuando la Pizarra está disponible, .balisewhiteboard también aparecen en Archivos. Un clic abre su vista visual en el espacio de trabajo de su carpeta; Balise nunca los presenta como Markdown o JSON editable.
Para un archivo de texto local existente, los menús de Archivos, las pestañas, el título de la ventana y las tarjetas Kanban presentan Copiar ruta, Copiar el contenido del archivo y después Mostrar en Finder. La copia del contenido lee la versión guardada en disco: no guarda el documento ni incluye sus cambios pendientes. La acción se oculta para carpetas, archivos ausentes o recursos no textuales. Se rechaza contenido de más de 8 MiB sin reemplazar el portapapeles.
Los enlaces están activos en Visual: una dirección externa se abre en la aplicación adecuada, un ancla desplaza el documento, un enlace a otro Markdown lo abre en el espacio actual y un enlace a otro tipo de archivo se entrega a macOS.
Las carpetas vacías siguen visibles en Archivos, incluso al cerrar y volver a abrir el espacio de trabajo. Esto también se aplica a Kanban, Datos y Mermaid.
Ordenar y organizar archivos
Opciones de visualización, abajo a la derecha de Archivos, agrupa la ordenación por nombre o fecha de modificación y el orden ascendente o descendente. La ordenación se aplica inmediatamente. Nueva carpeta… está en el menú de carpeta de abajo a la izquierda, después de las órdenes de apertura. Estos menús también están disponibles en los paneles Archivos de Datos y Mermaid.
Archivos ocultos… abre la edición de patrones de exclusión limitados a este espacio de trabajo. Una vista previa indica los elementos afectados antes de Aplicar. Cancelar abandona solo los cambios de patrones. La paleta busca archivos en las subcarpetas y muestra su ruta para distinguir los nombres repetidos.
Esquema sigue automáticamente la posición del cursor y el desplazamiento del documento en Visual. El seguimiento se suspende durante una búsqueda en Esquema para conservar la selección entre los resultados.
Los menús de archivos y carpetas ofrecen creación, duplicación, movimiento y envío a la Papelera. Antes de una operación que afecte a los enlaces, revise las rutas de origen y destino, las referencias que se modificarán y los documentos sin guardar. Balise pide guardar los documentos afectados o permite cancelar. Los archivos modificados desde la vista previa obligan a recalcularla. La restauración desde la Papelera rechaza sobrescribir un elemento recreado.
Se rechaza mover una carpeta que contiene tableros Kanban o pizarras para conservar sus referencias. También se rechaza mover un archivo referenciado en una pizarra. Los demás archivos del espacio de trabajo siguen utilizándose normalmente.
Resúmenes locales
En un espacio de trabajo, Balise genera un resumen conciso de dos frases para cada archivo .md o .markdown indexado y lo muestra debajo de su nombre en Archivos. El resumen conserva el idioma del documento y desaparece mientras se regenera en lugar de parecer actual después de una modificación.
Los resúmenes los produce el modelo Apple Intelligence instalado en el Mac. El contenido no sale del ordenador y ningún servicio remoto sirve de alternativa. Balise conserva la caché en la carpeta oculta .baliseindex en la raíz del espacio de trabajo; esta carpeta nunca reemplaza el Markdown ni se interpreta como contenido. Un antiguo .balise-index se renombra automáticamente cuando aún no existe el índice nuevo.
Para un archivo abierto solo, Balise pide una vez acceso explícito a la carpeta padre antes de crear .baliseindex allí. Cancelar deja el documento editable, pero sin resumen duradero; Permitir acceso sigue disponible para concederlo después. Eliminar .baliseindex retira solo resúmenes y metadatos reconstruibles; los archivos Markdown permanecen iguales.
Un documento vacío o sin contenido semántico nunca se envía al modelo. Archivos indica No hay contenido que resumir.
Revise las diferencias con sus herramientas Git habituales. Balise nunca escribe en Git.
La vista Pizarra también permite soltar archivos del espacio de trabajo y capturar una selección Markdown como tarjeta de fragmento.
Buscar y reemplazar
La búsqueda abarca el archivo activo y, cuando hay una carpeta abierta, todo el espacio de trabajo.
Los campos de búsqueda y reemplazo se alinean en dos líneas. A la derecha de la búsqueda, Aa activa la distinción de mayúsculas, ab subrayado busca una palabra completa y .* activa las expresiones regulares. Una ayuda describe cada opción. Sin expresión regular, Palabra completa considera las letras Unicode, las marcas de acento, los números y _ partes de la palabra. Los apóstrofos y los guiones la separan: gato-gato contiene dos palabras gato, mientras que gatos y mi_gato no coinciden con gato como palabra completa. Los acentos siguen siendo significativos.
En modo Texto, el patrón y el reemplazo son literales. En modo regex, utilice $1, $2… para reutilizar grupos capturados, $0 para toda la coincidencia y \$ para insertar un dólar literal. (?m) activa las anclas de línea y (?s) permite al punto abarcar saltos de línea. Una coincidencia de longitud cero inserta texto; una consulta vacía no realiza ninguna operación. Una expresión inválida muestra un diagnóstico y deja el documento intacto.
Las flechas recorren los resultados y revelan las secciones plegadas. El contador añade + si la búsqueda está incompleta. Las búsquedas costosas se interrumpen; Cancelar sigue disponible durante el cálculo. Una consulta nueva abandona la anterior.
En una carpeta abierta, los resultados se agrupan por archivo con un fragmento y número de línea. Los archivos abiertos se buscan en su contenido actual, incluidos los cambios sin guardar; los demás utilizan la versión indexada. Un resultado cuyo contenido ha cambiado provoca una búsqueda nueva.
Reemplazar y Reemplazar todo modifican solo el archivo activo. Reemplazar todo forma una única acción que se puede deshacer. Si el documento cambia durante la preparación, el reemplazo se rechaza. Las búsquedas limitadas nunca producen un reemplazo parcial silencioso.
Diagnósticos del documento
El inspector Documento cuenta títulos, enlaces y bloques técnicos y señala bloques sin cerrar, notas al pie sin definición, bloques técnicos demasiado grandes, una cantidad excesiva de bloques, enlaces a archivos ausentes, imágenes ausentes y anclas ausentes.
Cada diagnóstico se puede pulsar para volver al lugar afectado en Fuente.
Renombrar un archivo
Renombrar un documento desde la lista de archivos abre primero una vista previa completa: nombres anterior y nuevo, posible movimiento de la carpeta de recursos, archivos con enlaces que actualizar, destino anterior y posterior de cada enlace y número de línea de cada modificación.
Después, el cambio de nombre y la actualización de enlaces se aplican juntos. Si los archivos han cambiado desde la vista previa, la operación se rechaza y debe recalcularse.
Dividir Markdown en varios archivos
Elija Herramientas > Dividir Markdown…, o utilice el menú contextual de un archivo en la barra lateral. La hoja cuenta títulos H1, H2 y H3, desactiva los niveles con menos de dos títulos y muestra los nombres de todos los archivos previstos. Despliegue Opciones de nombres para utilizar los campos opcionales Prefijo y Sufijo. Ambos valores se colocan antes de la extensión y la vista previa se actualiza antes de escribir nada. Elija un nivel con al menos dos títulos y confirme con Dividir en N archivos.
Cada título elegido empieza un archivo y se convierte en su H1. Los títulos inferiores suben con él; los falsos títulos dentro de un bloque de código se ignoran. El texto anterior al primer título, incluido el front matter, se conserva en un archivo «Introducción». Los archivos nuevos se crean junto al original sin sobrescribir ninguno existente.
Mover el original a la Papelera después de la creación empieza desmarcado. Si lo activa, Balise mueve el original a la Papelera recuperable solo después de crear todos los fragmentos y reescribir los enlaces Markdown, wiki y los enlaces entrantes de la carpeta. Esta reescritura es automática y no añade una lista de enlaces a la hoja. Una modificación externa o un error cancela toda la operación.
Pedir a la IA que trabaje con documentos
Active Opciones experimentales en Ajustes > General y elija Herramientas > Preguntar a la IA… desde Markdown o Kanban. En Ajustes de OpenAI…, introduzca su clave API y elija Guardar la clave API. Balise conserva la clave en el Llavero de macOS; desactivar las opciones experimentales la conserva. Esta función utiliza una conexión a Internet y su acceso a la API de OpenAI. No reemplaza los resúmenes locales de Apple Intelligence.
Desde Markdown, la lista empieza por el documento activo, incluido un borrador sin guardar. Desde Kanban, utiliza las tarjetas Markdown seleccionadas. Añadir documentos… permite elegir otros archivos .md o .markdown. Quite de la lista los documentos que no quiera enviar. Al iniciar la solicitud, Balise lee el texto actual de los documentos abiertos, incluidos los cambios sin guardar; lee los demás archivos del disco. Si el mismo archivo tiene distintas versiones sin guardar en varias ventanas, deje una sola versión abierta antes de reintentarlo.
Elegir y conservar una instrucción
Escriba su solicitud en Instrucción, o cargue una de las seis Plantillas de instrucciones: Resumir, Comparar, Decisiones y acciones, Preguntas de aclaración, Síntesis temática e Informe para un agente. Puede editar el texto cargado antes de iniciar la solicitud. Cargar una plantilla, una instrucción reciente o un favorito no envía nada.
Instrucciones recientes conserva las diez últimas instrucciones iniciadas, de la más reciente a la más antigua, sin duplicados idénticos. El menú de cada entrada permite cargarla o quitarla; Borrar las instrucciones recientes vacía la lista.
En Instrucciones favoritas, elija Guardar la instrucción como favorita… y asígnele un nombre. Gestionar instrucciones favoritas… permite cambiar el nombre de un favorito, editar su texto o eliminarlo. Usar la instrucción actual copia su solicitud en el editor del favorito; después, elija Guardar cambios para conservarla. La biblioteca de instrucciones permanece en su Mac después de reiniciar Balise. Conserva sus instrucciones sin copiar los documentos de origen ni la clave API.
Generar y guardar la respuesta
Antes de elegir Generar, revise la lista de documentos y la instrucción. Balise envía sus nombres y su texto a OpenAI con su instrucción, utilizando GPT-6.1 Sol. Balise no añade las rutas locales completas al envío ni adjunta imágenes o archivos enlazados. El límite de 512 KiB abarca los nombres, los textos y la instrucción juntos; quite un documento o acorte la solicitud si Balise lo supera.
La respuesta llega progresivamente a un borrador Markdown nuevo en modo Fuente. Durante la generación, puede leer y copiar el texto; la edición y el guardado esperan a que termine. Elija Detener para interrumpir la respuesta y conservar el texto ya recibido. Una interrupción, un error o una respuesta incompleta deja un resultado marcado como parcial.
Al terminar, Procedencia indica el proveedor, el modelo, la fecha, el estado de la respuesta, la instrucción y los documentos utilizados. Los enlaces locales de esta sección permanecen en su borrador. Revise la respuesta y compruebe las citas con sus documentos antes de utilizarla. Los archivos de origen no cambian. Elija Archivo > Guardar para conservar el borrador nuevo, incluida una respuesta parcial.
Generar un diagrama Mermaid con OpenAI
En Markdown, en modo Fuente o Visual, elija Herramientas > Generar un diagrama con OpenAI… después de activar las opciones experimentales. La misma orden aparece en el menú Herramientas de la barra de herramientas y en la paleta de órdenes. Utiliza su clave API de OpenAI y GPT-6.1 Sol.
Seleccione texto antes de abrir la orden para convertirlo en un diagrama. Después de la generación y la comprobación, Balise inserta un bloque Mermaid nuevo después del último bloque completo afectado por la selección. El texto seleccionado permanece en su sitio, aunque la selección abarque solo una parte de un párrafo o una lista. La inserción forma un único cambio que se puede deshacer y no guarda el archivo.
Sin selección, Balise utiliza todo el documento Markdown y abre el resultado en un borrador Mermaid nuevo e independiente. El Markdown de origen no cambia. Después elija dónde guardar el borrador .mmd. Para un documento de solo lectura, quite la selección y vuelva a abrir la orden para utilizar este recorrido independiente.
Revise el contexto que muestra la ventana antes de enviarlo. En Tipo de diagrama, deje Automático o elija una familia concreta. Añada una Instrucción (opcional) para orientar el resultado; deje este campo vacío para utilizar la solicitud general de un diagrama fiel al texto. Elija Generar para enviar este contexto y la instrucción a OpenAI. Balise no carga imágenes ni archivos enlazados.
Balise espera la respuesta completa y después comprueba el código con su motor local de Mermaid antes de insertar o abrir el resultado. Esta comprobación verifica la representación; revise el significado del diagrama comparándolo con su texto. Si el documento de origen ha cambiado mientras tanto, Balise rechaza la inserción. El código sigue disponible para un borrador independiente.
Detener interrumpe la generación o la comprobación y conserva el código recibido. Después de una interrupción, un error o una respuesta incompleta, despliegue Código generado y elija Copiar código o Abrir como borrador Mermaid antes de cerrar la ventana para conservar el resultado. El código sin validar se abre en Fuente, donde puede corregirlo. Balise no repara la respuesta ni reintenta ninguna solicitud automáticamente. Para hacer otra solicitud, elija Generar; si el texto de origen ha cambiado, cierre y vuelva a abrir la herramienta para leer el contexto nuevo.
Copiar y pegar
Una copia desde Markdown coloca varias formas en el portapapeles: Markdown, texto sin formato, HTML y RTF. La copia visual reconvierte la selección; no garantiza una reproducción exacta de la fuente. Por eso los intercambios con un navegador, un asistente conversacional o un editor de texto enriquecido funcionan sin ajustes.
Transmitir contexto a un asistente
Elija Copiar contexto en la barra de herramientas y use el pegado normal (⌘V) en Codex, Claude o su asistente habitual. Balise copia el último resumen preparado, seguido de una referencia al archivo con su ruta completa. En Codex, la referencia aparece con el nombre del archivo y se puede pulsar. En el modo Code de Claude para macOS, los nombres aparecen como referencias nativas. Mantenga Balise abierto al pasar a Claude y pegar. La misma copia se adapta automáticamente al volver a Codex. En un destino de texto sin formato, la ruta completa permanece visible sin sintaxis de enlace Markdown. La presentación en otras aplicaciones depende de su compatibilidad con los enlaces locales.
Balise no añade un título «Resumen», no copia la fuente completa ni adjunta el archivo. El botón requiere un archivo guardado para poder proporcionar su ruta. Si no hay resumen disponible, la copia contiene solo la referencia. Si tiene cambios sin guardar, el resumen de la versión guardada sigue disponible con una indicación de ese estado. La copia no genera un resumen nuevo ni guarda el documento.
Si otra aplicación muestra solo un nombre sin ruta, pase a un editor de texto para recuperar la ruta completa. La referencia apunta a un archivo de su Mac; el asistente debe poder acceder a esa ubicación para leer su contenido.
Pegar en Markdown
Al pegar, Balise da prioridad al Markdown explícito. Si recibe HTML o RTF, lo convierte en un subconjunto Markdown prudente y retira scripts, estilos, marcos y controladores de eventos.
Después de copiar un rango en Datos, elija Editar > Pegar como tabla Markdown…. La vista previa confirma filas y columnas, permite elegir el encabezado, la alineación de cada columna y el tratamiento de saltos internos y después resalta las celdas que se escaparán. La primera fila sirve de encabezado por defecto. Las barras verticales se protegen, los saltos pueden convertirse en <br> y un rango de más de 1.000 celdas se rechaza sin modificar el documento. Un TSV irregular o ambiguo sigue disponible mediante el pegado normal sin conversión.
Editar > Pegar y adaptar estilo (⌥⇧⌘V) fuerza un pegado en texto sin formato.
Imprimir
Balise imprime la vista representada, incluidas ecuaciones y diagramas.
Lo que este espacio no hace
- Balise nunca escribe en Git: ni commits ni envíos a un repositorio remoto.
- Abrir y guardar sin editar conserva la fuente. Una edición visual puede transformar sintaxis extendidas, incluso en un párrafo vecino.
- El modo Visual no añade ningún estilo que no pueda expresarse en Markdown.
Kanban tiene su propia página: La vista Kanban.
Límites de las sintaxis extendidas
La auditoría del corpus Markdown observó que una edición visual vecina puede transformar el front matter. Las listas de definiciones reconocidas están protegidas. Para estos documentos, utilice Fuente y revise el resultado antes de guardar. La conservación sin edición no garantiza la conservación después de una edición visual o un pegado. En los casos mixtos comprobados, el pegado entre documentos Balise también puede degradar diagramas Mermaid y ecuaciones vecinos.
Listas de definiciones
Las listas formadas por un término seguido de líneas que empiezan por : muestran por separado los términos y sus definiciones. Varias definiciones y los párrafos con sangría permanecen en su bloque fuente protegido. Pegar una lista HTML conserva las asociaciones entre términos y definiciones.
Las listas existentes siguen apareciendo en Visual y Vista Rápida. Para crear o modificar una lista, utilice Fuente. No hay ninguna orden dedicada ni inspector de edición.
Siga este recorrido de principio a fin: Mantener la documentación de un repositorio.