Actualizado para Markion v0.3.1 · 2026-09-04

DOCUMENTACIÓN

Markdown y renderizado

Markion analiza Markdown con pulldown-cmark , orientado a CommonMark y GFM. Markdown sigue siendo el formato canónico del documento en todo momento.

Comandos de formato

Cubren negrita, cursiva, código en línea, enlaces, imágenes, títulos, listas, listas de tareas, citas, bloques de código delimitado y tablas Markdown de origen. Los títulos muestran H1–H5 por defecto, ampliables a H1–H6 en Preferencias.

Buscar y reemplazar

Admite distinción de mayúsculas, expresiones regulares, coincidencia siguiente/anterior, reemplazar actual y reemplazar todo.

Tablas

  • Los comandos de tabla en el origen formatean tablas y añaden, eliminan o mueven filas y columnas.
  • En edición visual, las tablas además permiten editar celdas con respaldo en el origen, recorrer con Tab , anchos de columna según el contenido y las mismas operaciones de filas y columnas.
  • Las tablas de la vista previa ordinaria siguen siendo de solo lectura.

Flujo de imágenes locales

Ingiere imágenes del portapapeles y archivos de imagen arrastrados:

  • Markion las copia o codifica en un directorio de recursos relativo al documento, con nombres resistentes a colisiones, e inserta enlaces Markdown relativos y portátiles.
  • Al sustituir una imagen existente se conservan el texto alt y los metadatos de presentación.
  • Hay controles prácticos de tamaño/alineación, y un recurso ausente muestra un estado explícito de falta.

Front matter YAML

Se analiza el front matter YAML delimitado por --- y se oculta en la vista previa; sus title, author y date alimentan los metadatos de exportación (etiquetas HTML <meta> , propiedades del documento DOCX y el preámbulo LaTeX).

Soporte de renderizado

La vista previa renderizada admite:

  • Negrita, cursiva, tachado, código en línea, enlaces, resaltado (==highlight==), superíndice (^superscript^), subíndice (~subscript~), notas al pie, listas de tareas, shortcodes de emoji habituales (como :smile: y :heart:) y enlaces automáticos.
  • Números de inicio correctos en listas ordenadas, listas anidadas, viñetas por profundidad, sangría colgante, imágenes y HTML incrustado.
  • Puntuación inteligente (comillas tipográficas, rayas) y atributos de título.

Copiar desde la vista previa

El texto de la vista previa se puede seleccionar, con un menú contextual para copiar como texto plano, Markdown o HTML, y la dirección del enlace cuando corresponda.

Matemáticas

$...$ fórmulas en línea y $$...$$ de bloque las compone sin conexión un motor RaTeX embebido (compatible con KaTeX) a SVG en caché con fuentes incluidas: no hace falta red ni LaTeX externo. En la práctica:

  • Las fórmulas en línea siguen el texto en la misma línea, y el Unicode funciona dentro (p. ej. $\text{速度 } v$).
  • Las matemáticas conviven con Markdown anidado como negrita, enlaces y código en línea, cada uno con su estilo.
  • ```math bloques delimitados (p. ej. entornos de matriz).
  • Las fórmulas muy anchas se desplazan en horizontal en lugar de recortarse.
  • El origen inválido de una fórmula permanece visible y editable, no desaparece en silencio.
  • En edición visual, solo la fórmula enfocada revela su origen completo $...$, $$...$$ o delimitado.

La exportación LaTeX conserva el origen nativo $...$/$$...$$ para la cadena de herramientas del lector; la exportación DOCX integrada degrada las fórmulas a una aproximación de texto plano legible, en lugar de incrustar glifos compuestos.

Diagramas Mermaid

```mermaid diagramas delimitados (flujos, secuencias y más) se renderizan a SVG desinfectado y en caché.

Resaltado de código

El código delimitado se resalta con syntect y el conjunto de gramáticas ampliado two-face, con un lexer de reserva para idiomas no cubiertos y números de línea opcionales (conmutables en Preferencias o config.toml ).