El editor Markdown

Un documento en Tisty es texto tuyo, guardado como un archivo .md normal, que escribes aquí y puedes leer con cualquier otro programa. Si mañana borras Tisty, tus documentos siguen abriéndose en cualquier editor de texto, en GitHub o en otra app de notas.

Escribir

• La primera línea es el título. No hay que ponerle nombre en ninguna parte: lo que escribas arriba es como se llama. Tisty se salta una valla de código o la marca de un aviso para encontrar la primera línea con palabras.
• Escribe / en cualquier punto y sale el menú de lo que cabe dentro: títulos, listas, casillas, tablas, avisos, código, diagramas, fórmulas, widgets, páginas, otro documento…
• Selecciona texto y aparece una barra con el formato y los rotuladores.
• Arrastra un archivo para adjuntarlo: una foto, un PDF. Queda guardado dentro de Tisty con el documento, no como un enlace a una ruta de tu disco que se rompe cuando mueves el archivo.
• Inserta otro documento y entra como una tarjeta que se puede abrir.
• Centra un párrafo o llévalo a la derecha.
• Las etiquetas se escriben en el texto: #contrato en medio de una frase archiva el documento bajo esa etiqueta. Mira Documentos.

El texto va sobre una hoja iluminada. Cuando la ventana es lo bastante ancha, se abre una columna al lado con qué es el documento, las opciones de formato y su índice.

El Markdown de siempre

Negrita, cursiva, tachado, subrayado, código suelto y enlaces. Listas con viñetas, numeradas y citas:

Lo que no está escrito, no ocurrió.

**Negrita**, *cursiva*, ~~tachado~~, <u>subrayado</u>, `código suelto`

1. Primero esto
2. Después lo otro

> Lo que no está escrito, no ocurrió.

Todo lo demás que cabe

Qué	Página
Avisos, rotuladores, iconos, casillas	Avisos y destacados
Tablas con alineación y ancho	Tablas
Diagramas desde bloques mermaid	Diagramas (Mermaid)
Fórmulas desde bloques math	Fórmulas
Pequeñas páginas HTML desde bloques widget	Widgets
Código con lenguaje, nombre y números de línea	Bloques de código
Capítulos, saltos de página y PDF	Páginas y PDF
Enlaces dibujados como tarjeta	Tarjetas de enlace

Sigue siendo Markdown

Eso es lo importante, no un detalle. Todo lo que Tisty añade es sintaxis que otro lector ya entiende, así que el archivo sobrevive sin Tisty:

• Un aviso es un aviso de GitHub (> [!WARNING]).
• El nombre de un bloque de código es lo que Markdown ya guarda después del lenguaje (```bash title="backup.sh").
• El ancho de una columna viaja en lo larga que se dibuja su raya, algo que los demás lectores ignoran.
• Donde Markdown de verdad no puede decir algo (un icono dentro de una línea, el color de un rotulador), Tisty escribe el pedacito de HTML que sí puede, y lo vuelve a leer.

Cuando un documento se abre solo para leer

Hay tres motivos distintos, y la barra al pie del documento dice cuál es.

Está en el archivo. Archivar un documento, o la carpeta en que está, lo cierra a la escritura, tanto desde la ventana como desde un asistente. Desarchívalo y se vuelve a escribir.

Una página suya está archivada, o lo está el documento que la contiene. Mira Páginas y PDF.

O lo que está en riesgo es la escritura misma. El editor vuelve a escribir Markdown, y unas pocas formas no sobreviven ese viaje:

• la cabecera (front matter) al principio del archivo,
• las notas al pie,
• los enlaces escritos por referencia,
• los bloques de HTML, los comentarios HTML y las entidades,
• lo que una valla de código diga después del lenguaje, aparte de un nombre,
• un elemento de lista que empieza con un bloque (una cita, una valla, un título, una imagen u otra lista) en vez de texto.

En vez de abrir el documento y destruirte eso en la primera tecla, Tisty te avisa y lo abre para leer. La barra ofrece Intentar convertirlo y editar: lo reescribe a lo que el editor sí sabe conservar y guarda una copia de cómo estaba junto a los documentos. Si la conversión no puede con todo, Editarlo igualmente te lo abre con el aviso a la vista, para que tú decidas qué vale la pena perder. Nunca te quedas encerrado.

Sin conexión, siempre

Los diagramas, las fórmulas, el color del código y los widgets se dibujan con código que viaja dentro de Tisty. No se descarga nada, no se carga ninguna fuente de afuera y todo funciona con el cable desenchufado.