Markion
简繁ENDEESFRJA
Obtener Markion
Actualizado para Markion v0.3.1 · 2026-09-04

DOCUMENTACIÓN

Preguntas frecuentes

Respuestas sobre plataformas, actualizaciones, Markdown, recuperación y solución de problemas, más las limitaciones conocidas de la versión actual.

¿Qué es Markion?

Markion es un editor Markdown nativo de escritorio hecho en Rust con el marco de UI acelerado por GPU GPUI. Ofrece cuatro modos —Edición, visual, dividida y Lectura— más esquema, árbol de archivos, buscar y reemplazar, modos foco y máquina de escribir, y exportación a varios formatos.

¿Qué plataformas se admiten?

PlataformaDestinoNotas
Windowsx86_64-pc-windows-msvcWindows 10 y posteriores; instalador NSIS .exe
macOSaarch64-apple-darwinNativo de Apple Silicon; mínimo macOS 11.0; no hay paquete Intel ni binario universal por ahora
Linuxx86_64-unknown-linux-gnuCompilado en Ubuntu 22.04; se entrega como .deb y .AppImage

Las versiones no están firmadas por la plataforma; al primer arranque puedes ver avisos de Gatekeeper (macOS) o SmartScreen (Windows); elude a mano para ejecutar. El actualizador in-app de Windows x86_64 verifica por separado su carga NSIS con una clave Minisign, lo que no silencia SmartScreen. macOS y Linux abren la descarga en el navegador del sistema. Quien instala el .deb en Linux recibe las bibliotecas de runtime necesarias (Wayland / X11 / Vulkan / fontconfig) automáticamente.

¿Qué funciones de Markdown se admiten?

Markion usa pulldown-cmark (CommonMark + GFM) con lo siguiente activado:

  • Base CommonMark
  • GitHub Flavored Markdown: tablas, tachado, listas de tareas, autolinks
  • Notas al pie
  • Fórmulas ($inline$ y $$block$$)
  • ```mermaid Diagramas Mermaid (bloques : flujos, secuencias y más)
  • Puntuación inteligente (comillas tipográficas, rayas)
  • Atributos de título
  • Front matter YAML (delimitado por ---, title / author / date para exportar)
  • Sintaxis en línea ampliada (propia de Markion, sobre los tramos de pulldown-cmark): ==highlight==, ^superscript^, ~subscript~, shortcodes emoji como :smile: y :heart:, autolinks desnudos

Véase Markdown y renderizado para los detalles. Las notas al pie están siempre activas: no hay interruptor.

¿En qué se diferencian los cuatro modos?

Recorre los cuatro modos con Ctrl+Shift+V (el predeterminado es edición visual), o salta a uno con Ctrl+//Ctrl+E/Ctrl+P/Ctrl+R: Edición (solo origen), visual (WYSIWYG primero, con origen), dividida (origen a la izquierda, vista a la derecha) y Lectura (solo vista renderizada, no editable). Al cambiar se conservan documento, cursor/selección, deshacer y el desplazamiento de cada pestaña. Véase Modos de edición.

¿Cómo se componen las matemáticas?

El renderizado en pantalla (vista dividida/lectura y edición visual) usa un motor RaTeX embebido (compatible con KaTeX, fuentes incluidas) para $inline$ y $$block$$ en SVG en caché: sin red ni LaTeX externo. La exportación LaTeX conserva el origen nativo $...$/$$...$$ para la cadena del lector; el DOCX integrado degrada las fórmulas a una aproximación Unicode de texto plano.

¿Cómo funcionan el autoguardado y la recuperación?

Markion escribe instantáneas de recuperación tras cinco segundos de inactividad por defecto y guarda en silencio los archivos con nombre. Preferencias → General permite desactivar el guardado silencioso (la recuperación sigue) o fijar 1–300 segundos. enabled = false desactiva ambos:

[auto_save]
enabled = true
silent_save = true
delay_secs = 5

En documentos nunca guardados, Markion escribe una copia de recuperación. Si se cierra de golpe, el siguiente arranque ofrece restaurar el trabajo. La barra de título muestra un * junto al nombre si hay cambios sin guardar.

¿Cómo rinde con documentos grandes?

Markion guarda en caché el estado derivado (bloques de vista previa, esquema, estadísticas, resaltado) por versión de documento y lo comparte vía Arc, así que teclear en documentos grandes no lo recalcula todo en cada pulsación. El registro de gramáticas syntect se carga fuera del hilo principal al arrancar. La edición visual con mapa de origen reutiliza de forma incremental regiones parseables tras ediciones locales y vuelve a una derivación completa si el contexto o los rangos de bytes son inciertos; la vista dividida/lectura sigue con debounce y caché, no incremental. Markion usa un búfer String en vez de un rope; algunas lecturas semánticas exigen a propósito un análisis completo.

Solución de problemas

  • macOS dice que Markion «no se puede abrir porque proviene de un desarrollador no identificado». Es Gatekeeper. Clic derecho en la app y Abrir, o en Ajustes del Sistema → Privacidad y seguridad pulsa Abrir de todos modos. Las versiones no están firmadas.
  • Windows SmartScreen avisa antes del instalador. Pulsa Más información → Ejecutar de todos modos. Las versiones no están firmadas.
  • ¿Cómo elijo un motor PDF? Abre Preferencias → Exportar y elige el motor integrado o Pandoc. El integrado admite CJK, imágenes, tablas, código y matemáticas vectoriales sin herramientas externas. Pandoc necesita su cadena y vuelve al integrado si falta o falla. La barra de estado indica el motor usado.
  • Un tema propio no aparece en Preferencias. Confirma que el .toml está en el directorio de temas (véase la tabla de directorios en Temas, idiomas y preferencias), que name está puesto y no vacío, y que ningún tema incluido tiene el mismo nombre (los incluidos tienen prioridad).
  • ¿Dónde están los registros? Véase la columna de registros de la tabla de directorios en Temas, idiomas y preferencias. Define RUST_LOG=debug antes de arrancar para más detalle.

Limitaciones conocidas

  • La edición visual es WYSIWYG primero y conserva el Markdown canónico; lo que no tiene render byte-exacto demostrado expone el origen exacto como canal transitorio (hoja de ruta WYSIWYG) en vez de una mutación de árbol rico adivinada; reordenar bloques solo si los límites no se solapan de forma demostrable.
  • El renderizado en pantalla compone matemáticas con RaTeX embebido; la exportación LaTeX conserva $...$/$$...$$ nativo, y el DOCX integrado sigue degradando fórmulas a texto plano legible en vez de glifos compuestos.
  • Las celdas visuales admiten texto plano directo, pero aún no controles ricos en línea. Imágenes de referencia/multilínea, tablas malformadas y entidades HTML en el cuerpo siguen siendo huecos conocidos de la hoja de ruta WYSIWYG con camino de origen.
  • Las actualizaciones de un clic instalan la distribución NSIS de Windows tras Minisign; el reemplazo del paquete macOS y el auto-reemplazo .deb/AppImage en Linux son trabajo futuro, y la autenticación no es Authenticode ni notarización de Apple.
  • No hay una UI completa de instalación de temas; los archivos de tema se colocan a mano en el directorio de temas.
  • La exportación de imagen es una instantánea estática de la maquetación; los documentos muy grandes aún no usan rope ni análisis incremental completo en cada subsistema derivado.

Informar errores

Abre incidencias en GitHub Issues. Incluir la versión de Markion (primera línea del registro al arrancar) y la plataforma ayuda.