UStackUStack
Quarkdown icon

Quarkdown

Quarkdown es un sistema de maquetación moderno y open-source basado en Markdown: vista previa reactiva y varios modos de salida con .doctype.

Quarkdown

¿Qué es Quarkdown?

Quarkdown es un sistema de maquetación moderno, open-source y basado en Markdown para escribir documentos con un flujo de trabajo similar a LaTeX. Su propósito principal es permitirte crear contenido en Markdown y compilarlo en salidas formateadas para artículos, presentaciones, bases de conocimiento y sitios web estáticos.

El sitio posiciona a Quarkdown como un único sistema de autoría que puede reemplazar múltiples herramientas según el tipo de salida, incluyendo flujos de trabajo de documentos tipo LaTeX y formatos comunes de documentación/wiki.

Características clave

  • Autoría centrada en Markdown para escribir contenido en un formato diseñado para la legibilidad y edición rápida.
  • Extensiones para formato adicional y comportamiento más allá del Markdown simple, descritas como “extensiones para lograr más”.
  • Múltiples tipos de salida seleccionados mediante el “doctype” del documento (p. ej., paged, plain, docs, slides) para dirigir a diferentes entregables.
  • Vista previa reactiva con resultados en vivo mientras escribes, respaldada por “compilación ultrarrápida y vista previa en vivo”.
  • Capacidades de scripting descritas como “Turing completas” e intendedas para ayudarte a reutilizar tu flujo de trabajo en lugar de repetirlo.

Cómo usar Quarkdown

Comienza escribiendo tu contenido en Markdown, luego elige un tipo de documento apropiado usando la configuración .doctype {…} de Quarkdown (por ejemplo, un artículo/informe paginado, una nota/conocimiento simple, contenido estilo docs o diapositivas). Mientras editas, usa la retroalimentación de vista previa/compilación en vivo para ver cómo se renderiza tu salida.

Si necesitas formato especializado o estructuras repetidas, usa las extensiones y construcciones de scripting de Quarkdown (la documentación muestra ejemplos como definir funciones y renderizar bloques repetidos) para generar secciones consistentes desde lógica reutilizable.

Casos de uso

  • Escribir un artículo de investigación o informe usando un tipo de documento paginado (.doctype {paged}) para diseño estilo artículo/libro/informe.
  • Mantener una base de conocimiento personal o sitio estático simple usando un doctype simple (.doctype {plain}) cuando quieres notas y publicación directa.
  • Construir un wiki de equipo o conjunto de documentación técnica usando salida orientada a docs (.doctype {docs}), adecuada para bases de conocimiento grandes y lectura estilo documentación.
  • Preparar materiales de clase o charlas usando un doctype de diapositivas (.doctype {slides}) para formatear contenido para presentaciones interactivas.
  • Generar estructuras visuales repetidas o tipo datos mediante scripting y extensiones (los ejemplos del sitio muestran funciones y “cards” o bloques repetidos con imágenes y metadatos).

Preguntas frecuentes

  • ¿Qué tipos de salidas soporta Quarkdown? El sitio describe modos doctype para artículos/libros/informes paginados, notas simples/sitios web estáticos simples, bases de conocimiento estilo docs, y diapositivas para clases y charlas.

  • ¿Quarkdown ofrece vista previa mientras escribo? Sí. Publicita vista previa en vivo con compilación rápida para que veas resultados mientras escribes.

  • ¿Es Quarkdown compatible con flujos de trabajo estilo LaTeX? La página indica que Quarkdown reemplaza a LaTeX para artículos/libros/informes, lo que significa que apunta a ese flujo de documentos en lugar de requerir una cadena de herramientas LaTeX separada.

  • ¿Cuál es el rol de las extensiones y el scripting? Las extensiones se describen como una forma de lograr formato y comportamiento más allá del Markdown básico, mientras que las capacidades de scripting se describen como Turing completas para reutilizar lógica de flujo de trabajo y evitar repetirlo.

  • ¿Es Quarkdown open source? Sí. La meta descripción y el texto de la página lo llaman “open-source”.

Alternativas

  • Una cadena de herramientas de maquetación LaTeX/Typst para preparación de documentos tradicionales cuando prefieres un lenguaje o ecosistema de maquetación dedicado.
  • Un enfoque de generador de sitios estáticos para documentación/wiki (por ejemplo, herramientas en la categoría “docs”) si tu objetivo principal es publicar documentación estructurada en lugar de usar Markdown más maquetación con múltiples modos doctype.
  • Un framework de presentaciones basado en Markdown para autoría de diapositivas si principalmente necesitas mazos de diapositivas y menos un sistema unificado para artículos y bases de conocimiento.
  • Una plataforma general de wiki/notas si quieres un entorno de edición y publicación totalmente gestionado en lugar de un flujo de trabajo orientado a maquetación impulsado desde Markdown.
Quarkdown | UStack