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.

Notas que hacen las cuentas: fórmulas, diagramas y código en Markdown llano

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 + M muestra 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.