Editor Markdown - rgdevment/Tisty GitHub Wiki
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 donde lees
Hay una sola forma de escribir, y ocurre en la misma página.
- Haz clic en un bloque y se abre ahí mismo, con el cursor donde hiciste clic. El resto de la página sigue como se lee.
- Las marcas no se ven. La negrita se ve en negrita y un título se ve como título; los
**o el#solo aparecen donde el cursor toca ese formato, para que veas lo que estás cambiando. - Los títulos, las listas, las etapas, las citas y los avisos siempre se dibujan, también mientras los escribes: una viñeta es una viñeta, una casilla es una casilla que puedes marcar, un aviso lleva su color y su nombre.
- Esc, o un clic fuera, vuelve a la lectura. Lo que escribes se guarda sobre la marcha, y el pie de la página te lo dice.
- La primera línea es el título. No hay que ponerle nombre en ninguna parte: lo que escribas arriba es como se llama.
Ctrl/⌘+Shift+Mmuestra todas las marcas del bloque, para cuando quieres ver el Markdown tal cual. Vuelve a pulsarlo para ocultarlas.
Una línea al pie de la página deja las teclas a la vista: / para insertar, # y un espacio para un título, el atajo de todas las marcas y Esc para leer.
La barra
Mientras un bloque está abierto, flota sobre él una barra:
- El tipo de bloque: Párrafo, Título, Subtítulo, Título pequeño, Lista con viñetas, Lista numerada, Etapas o Cita. Todas las líneas que tengas seleccionadas cambian de una vez.
- Negrita, cursiva, subrayado, tachado, código y enlace.
- Cuatro rotuladores: amarillo, verde, azul y rosa.
- / Más, que abre el menú
/.
Con palabras seleccionadas, un formato las envuelve; pulsado sobre palabras que ya lo tienen, se lo quita. Los formatos nunca se cruzan: uno que alcanza a otro igual se junta con él en uno solo.
Sin nada seleccionado, el formato empieza justo donde está el cursor, y lo que escribes ya se ve en negrita, subrayado o amarillo. Vuelve a pulsarlo para salir de él, o pulsa otro rotulador para cambiar el color. Enter o una flecha también lo terminan.
El menú /
Escribe / en cualquier punto y sale el menú de lo que cabe. Sigue escribiendo para filtrar, ↑ ↓ para moverte, Enter para agregarlo, Esc para cerrarlo.
- Títulos, listas, etapas y citas.
- Los cinco avisos: Nota, Consejo, Importante, Aviso y Cuidado.
- Negrita, cursiva, subrayado, tachado, código, enlace y el rotulador, con sus atajos al lado.
- Un icono, buscado por lo que dibuja.
- Un diagrama, una fórmula, un widget y un bloque de código.
- Una tabla.
- Una sección plegable: un título que pliega lo que tiene debajo.
- Un salto de página.
- Otro documento, un documento nuevo, una página que ya existe o una página nueva, dibujados como tarjeta.
Mientras escribes
- Las etiquetas se ofrecen después de
#. Las que ya usas aparecen mientras escribes, para que una etiqueta nunca se escriba de dos maneras. Lo que escribiste queda primero, así que Enter guarda una etiqueta nueva tal como está. - Un elemento vacío termina la lista. Enter en una viñeta, un número o una casilla vacíos sale de la lista con una línea en blanco, para que lo que escribas después no se pegue al último elemento.
- Retroceso justo después de la marca de una línea (el
#de un título, una viñeta, el>de una cita) vuelve la línea a texto. - Inicio te deja en las palabras, pasada la marca de la línea.
- → al final de las palabras de un enlace nuevo entra en su dirección.
- Adjunta un archivo arrastrándolo a la página, pegándolo (también sirve una captura en el portapapeles) o eligiendo Adjuntar un archivo en el menú
/. Queda donde está el cursor, o después del bloque donde lo sueltas, y se guarda dentro de Tisty con el documento, no como un enlace a una ruta de tu disco que se rompe cuando mueves el archivo. - Pega con su formato. Lo que copias de una página web, un correo o un procesador de texto conserva sus títulos, listas, negritas, enlaces, tablas y palabras de color, escrito en el lenguaje de Tisty: un color pasa al rotulador más cercano de la paleta. El texto plano también conserva su forma: una tabla que una terminal dibujó con líneas (
┌ │ ├) pasa a ser una tabla, y las líneas que se leen como código, copiadas de un editor de código o de una terminal, entran como bloque de código, salvo que el cursor ya esté dentro de uno. - Marca una casilla en la página con un clic, sin abrir el bloque.
| Atajo | Qué hace |
|---|---|
Ctrl/⌘ + B |
Negrita |
Ctrl/⌘ + I |
Cursiva |
Ctrl/⌘ + U |
Subrayado |
Ctrl/⌘ + Shift + X |
Tachado |
Ctrl/⌘ + E |
Código |
Ctrl/⌘ + K |
Enlace |
Ctrl/⌘ + Z · Ctrl/⌘ + Shift + Z |
Deshacer · rehacer |
Ctrl/⌘ + Shift + M |
Mostrar u ocultar todas las marcas |
Esc |
Volver a la lectura |
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, sus etiquetas, su índice y el camino a su PDF.
El Markdown de siempre
Negrita, cursiva, tachado, código suelto y enlaces. Listas con viñetas, numeradas y citas:
Lo que no está escrito, no ocurrió.
**Negrita**, *cursiva*, ++subrayado++, ~~tachado~~, `código suelto`
1. Primero esto
2. Después lo otro
> Lo que no está escrito, no ocurrió.
Cada marca que puede llevar un documento, con sus reglas, está en El lenguaje de Tisty.
Todo lo demás que cabe
| Qué | Página |
|---|---|
| Cada marca, tal como queda en el archivo | El lenguaje de Tisty |
| Avisos, rotuladores, iconos, etapas | 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 está escrito para que otro lector lo siga mostrando, y 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 no tiene palabra (un subrayado, el color de un rotulador, un icono, una sección que se pliega), Tisty tiene una corta propia (
++subrayado++,==texto=={green},::dog::,:::details), que otro lector muestra como texto normal.
Lo que Tisty no sabe decir
Algunas cosas de Markdown que vienen de otra parte (las etiquetas HTML) no tienen palabra en Tisty. Un documento que las lleva se abre, se edita y se guarda entero: no se corta nada. Esa parte simplemente se ve tal como está escrita mientras la editas. Configuración › Mantenimiento recorre todos los documentos y te lista los que llevan algo de eso. La lista completa está en El lenguaje de Tisty.
Cuando un documento se abre solo para leer
La barra al pie del documento dice por qué.
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.
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.