Quarkdown - Markdown con funciones potentes añadidas

• Combina la redacción de documentos basada en Markdown con capacidades de composición tipográfica al nivel de LaTeX, para poder trabajar con un solo instrumento desde artículos académicos hasta libros, presentaciones, sitios estáticos y bases de conocimiento
• Dentro de una sintaxis con menos boilerplate, permite insertar directamente elementos como autor, márgenes, resumen, imágenes y citas, para escribir contenido y maquetación al mismo tiempo
• Con una sola línea de configuración .doctype, cambia entre los tipos de documento paged, plain, docs y slides, e incluso admite presentaciones interactivas
• Ofrece compilación rápida y vista previa en vivo, y con scripting Turing complete permite reutilizar funciones y argumentos para reducir el trabajo repetitivo de maquetación
• Se ofrece como código abierto gratuito, supera las 10K stars en GitHub, incluye integración con VS Code y cuenta con Quickstart y documentación para ampliar sus posibilidades de uso y extensión

---

Características principales

• Un sistema moderno de creación de documentos que combina Markdown con capacidades de composición tipográfica al nivel de LaTeX
• Está diseñado para manejar con una sola herramienta artículos académicos, libros, presentaciones, sitios estáticos y bases de conocimiento
• Es gratuito y se ofrece como código abierto; el compilador sigue evolucionando y se mantiene como software libre
• Quarkdown, Wiki, Discuss

Experiencia de escritura

• Diseñado para que puedas concentrarte en escribir sin boilerplate
• Permite insertar directamente en la sintaxis elementos como docauthor, pagemargin, abstract, imágenes y citas, para trabajar al mismo tiempo con la maquetación del documento y el contenido
• El documento de ejemplo está estructurado como un flujo donde se escriben en un mismo archivo el título, el autor, los márgenes, las imágenes, el resumen y las citas
• Gracias a la sintaxis extendida, ofrece más posibilidades expresivas que Markdown básico

Tipos de documento y doctype

• El tipo de documento se cambia con una sola línea de configuración .doctype
• paged se usa para artículos, libros e informes
• plain se usa para notas, bases de conocimiento y sitios web estáticos simples
• docs se usa para wikis, documentación técnica y bases de conocimiento grandes
• slides se usa para clases, exposiciones y presentaciones interactivas

Vista previa reactiva y scripting

• Con compilación rápida y vista previa en vivo, puedes ver los resultados al instante mientras escribes
• Incluye funciones de scripting Turing complete para reducir tareas repetitivas
• Permite aplicar el mismo patrón de maquetación a varios elementos mediante la definición de funciones y la reutilización de argumentos
• En el ejemplo, después de definir la función animal, se reutiliza la composición de nombre, ecosistema e imagen para generar varios elementos

Instalación y ruta de inicio

• En la sección de instalación se indica que v2.0.0 fue lanzado el 23 de abril de 2026
• Linux / macOS: curl -fsSL https://raw.githubusercontent.com/quarkdown-labs/get-quarkdown/… | sudo env "PATH=$PATH" bash
• macOS Homebrew: brew install quarkdown-labs/quarkdown/quarkdown
• Windows: irm https://raw.githubusercontent.com/quarkdown-labs/get-quarkdown/… | iex
• Windows Scoop
  • scoop bucket add java
  • scoop bucket add quarkdown https://github.com/quarkdown-labs/scoop-quarkdown
  • scoop install quarkdown
• Explore
• Get started →

Ecosistema y recursos

• Se muestra con más de 10K stars en GitHub
• Ofrece rutas de aprendizaje e integración con el editor mediante Quickstart, Docs, VS Code y Wiki

[GN⁺]

Comentarios en Hacker News

• La verdad sí impresiona, pero para mí la esencia de Markdown está en su simplicidad extrema
  Se puede editar sin GUI, puedes escribirlo en VIM desde la terminal y aun así hacerte una idea de cómo se va a ver el resultado, y el archivo .md en crudo también se lee bien por sí solo
  Pero si le empiezas a seguir agregando funciones, terminas teniendo que buscar comandos raros a cada rato, al final ni te los acuerdas, y sin renderizado ya no estás seguro de cómo va a quedar, así que acabas deseando un editor WYSIWYG
  Se parece a la idea de meter letras cirílicas, devanagari, chino y árabe en un teclado QWERTY, y entonces al final sientes que vuelves al hunt and peck

  • Para mí, una de las grandes ventajas de Markdown es que es medio WYSIWYG
    Su sintaxis básica reutiliza la forma en que la gente ya imitaba formato dentro del texto, así que lo que escribes normalmente sigue siendo fácil de leer tal cual
    Aunque no sepas exactamente cómo escribir Markdown, por lo general no tienes problema para leerlo; las tablas se ven como tablas y los párrafos como párrafos
    A veces sí tengo que volver a buscar la sintaxis, pero eso está bien. Es natural que el vocabulario pasivo sea más grande que el activo
    Por eso yo suelo juzgarlo por la legibilidad del texto fuente, y muchas de las cosas que muestran aquí no me parecen una gran ganancia según ese criterio
    Eso sí, no vi ejemplos de formato de ecuaciones, y las pocas veces que uso LaTeX suele ser justo por fórmulas matemáticas que Markdown no puede hacer, así que sí me da curiosidad ver cómo se vería esa parte en la práctica
  • Ese argumento es bastante convincente
    Aun así, Quarkdown claramente se ve como un paso más allá de escribir LaTeX directamente, y también parece ofrecer mejor previsibilidad del resultado y mejor compatibilidad con edición asistida por LLM que un editor GUI como Word
  • Solo hay que hacer un Quarkdown con más superpoderes, sin necesidad de memorizar comandos raros y con una UI/UX pulida
    Podría llamarse Microsoft Word
  • Yo también estoy haciendo un pequeño renderer de Markdown, y hasta ponerle nombre ya es difícil, pero lograr que la gente lo use cuando esté listo lo es todavía más
    Hoy en día es difícil destacar con un editor de "plain markdown" a secas, y para llegar a la portada de HN parece que al final sí necesitas funcionalidad y nivel de acabado que vayan más allá del Markdown normal
    Se siente como una especie de selección natural
  • Obsidian.md es realmente excelente como editor WYSIWYG para Markdown básico

• Ojalá hubiera algún recurso que comparara todas estas herramientas y lenguajes de marcado de una vez
  Estaría bien ver MyST, Pandoc, Quarkdown, Quarto y Typst uno al lado del otro
  Quarto y Pandoc usan Pandoc Markdown, y https://www.zettlr.com/ también
  En cambio, Quarkdown y Typst se sienten más como lenguajes de marcado programables cercanos a LaTeX o a HTML+Javascript, así que todavía no parece decidido quién va a ser el verdadero sucesor de LaTeX

  • He usado casi todos y pienso seguir usándolos, y más o menos yo los separaría así
    Markdown es básicamente .txt con un poquito de azúcar sintáctica, y lo puedes exportar a PDF o HTML
    Quarto es Markdown cuando quieres ejecutar bloques de código
    Typst es LaTeX rehecho de manera moderna, así que se deshizo del 90% de lo molesto, pero también parece que perdió como un 10% de funcionalidad
    La academia ya de por sí odia lo nuevo, así que incluso si usas Typst probablemente no les va a entusiasmar
    Pandoc al final es una herramienta para exportar a toda clase de formatos como PDF y HTML
    En general se ve rápido cuál de esos necesitas, y también existen cosas como asciidoc, pero si piensas qué áreas no cubre la combinación markdown/quarto/typst, no quedan muchas
    Lo único que realmente sobra sería un editor WYSIWYG
  • También valdría la pena incluir djot en la comparación
    Parece un superset de Markdown bien diseñado y bastante riguroso
    https://djot.net/
  • De verdad quería que me encantara Typst
    Habría sido increíble no tener que usar más LaTeX, pero al probarlo en un proyecto real me topé con demasiados casos borde y al final tuve que volver a LaTeX
    Le faltan cosas que sí están en LaTeX, y también pesó mucho la falta de convertibilidad con Pandoc
    Ojalá logre completar ese último 10%
  • Si te refieres a una comparación así, ya existe
    https://github.com/iamgio/quarkdown#comparison
  • Pandoc está en otra capa distinta a las demás herramientas
    Puedes aplicar filtros arbitrarios sobre su formato JSON intermedio, así que en la práctica puedes implementar casi cualquier transformación que quieras, y además convierte múltiples formatos hacia ese JSON o desde él
    Por eso yo prefiero los sistemas basados en Pandoc, y muchas veces algo que la herramienta base no hace se resuelve con un inline filter sencillo

• Según el modelo estándar del software de física, si editas Quarkdown en Atom se convierte en Quarkup, y además tendrías que cambiar Neutron Mail por Proton Mail
  Eso sí, solo funciona si escribes con la mano izquierda mientras haces una app en Electron y hasta publicas un anti-Neutrinos AI blogpost

• Mi opinión corta es que esto en realidad se parece más a Markdown con macros estilo LaTeX
  Solo que aquí las llaman funciones, probablemente porque hay al menos una función con efectos secundarios: la función que define nuevas funciones
  Me gusta la pureza sintáctica de que "todo sea una función", pero me deja sensaciones mixtas que estructura y estilizado estén mezclados de una forma que recuerda a HTML/CSS. Aunque, claro, esa frontera siempre ha sido difusa
  Aun así, está bastante bien, y entiendo por qué hay tantas reacciones escépticas a cualquier intento de cambiar mucho Markdown
  También es válida la crítica de que abusar de las funciones puede perjudicar la legibilidad de la fuente, y a veces la incompletitud de Turing también es una ventaja
  Pero visto estrictamente como un diseño para agregar funciones a Markdown, me parece un diseño bastante limpio

• Soy el autor y líder del proyecto Quarkdown
  Al principio empezó como un proyecto de investigación universitario, y nunca imaginé que dos años después se vería así
  Gracias por el interés; voy a tratar de responder la mayor cantidad posible de comentarios

  • Me pregunto si en v3 piensas "arreglar" la sintaxis de negritas
    Yo siempre he pensado que **bold** y *italic* tienen menos sentido que *bold* y _italic_
    Ese asterisco extra de Markdown no me parece una gran decisión de diseño, y sobre todo es bastante incómodo cuando editas Markdown en el celular o en una tablet
  • La idea de meter funciones dentro de un formato de texto se siente bastante inusual
    Incluso en documentos GUI la gente normalmente evita las macros, así que me da curiosidad si Quarkdown fue diseñado originalmente para documentos complejos y repetitivos
    Gracias por abrirte a preguntas
  • Leí https://iamgio.eu/2025-12-10-accidentally-in-silicon-valley/ y me alegra ver que parece que te está yendo bien

• Después de hojear la documentación, me preocupa un poco si el modelo de evaluación encaja bien con esta tarea
  En layout de texto normalmente ajustas una parte y eso rompe la colocación de otras, así que hay que volver a correr el proceso de layout, repitiendo hasta llegar a un punto fijo
  Typst tiene el concepto de context para eso https://typst.app/docs/reference/context/, pero no vi nada parecido en Quarkdown. Puede que se me haya pasado
  En trabajo de libros me cambié de una combinación pandoc/md/LaTeX a Typst, y estoy bastante satisfecho
  Se siente bien programar en un lenguaje moderno, y además es muchísimo más rápido que pandoc+LaTeX
  https://functionalprogrammingstrategies.com/

• Viniendo desde AsciiDoc, el diseño sintáctico de Quarkdown se ve limpio, y en particular me gustan las funciones definidas por el usuario
  Pero siento que lo más difícil en esta categoría no es tanto el lenguaje fuente sino el pipeline de salida
  Extensiones de Markdown como referencias cruzadas, admonitions, contenido condicional o reutilización basada en funciones sí se pueden resolver bien a nivel de diseño
  El verdadero muro viene después: por ejemplo, tagged PDF que cumpla PDF/UA, builds deterministas que no se rompan al cambiar de entorno, hreflang y cross-document linking en sitios multilingües, o incremental rebuild que aguante incluso libros de 500 páginas
  Sobre todo en la UE, la importancia de PDF/UA ha crecido desde que el European Accessibility Act entró en vigor el 28 de junio de 2025
  Me da curiosidad qué planes tienen para los cuatro doctype, especialmente para paged

• MyST también debería estar en la tabla comparativa
  https://mystmd.org/
  Esto sí podría convertirse en el nuevo estándar de Markdown en el futuro

  • O también podrías incluir Typst
    No es una extensión de Markdown, pero sus objetivos y casos de uso son bastante parecidos
  • La combinación MyST + Sphinx es muy buena
    Aunque sí se extraña un soporte fuerte de LSP; por lo menos yo no logré hacerlo funcionar bien en helix
    Mi blog también está hecho con pydata-sphinx-theme y myst
  • No conozco mucho de esa área
    Si quieres, puedes actualizar tú mismo la tabla con un PR

• En mi app tomé un enfoque un poco distinto
  Me enfoqué en la legibilidad y en que fuera fácil manejar diagramas grandes de Mermaid, y recientemente también añadí un modo de pantalla completa para navegar como si fuera un mapa
  https://mdview.io/s/97af684b

• Cuando uso un SSG, prefiero mantener la entrada lo más cercana posible a Markdown limpio, y dejar los detalles de formato concentrados en CSS
  Por ejemplo, no hace falta usar algo como .abstract si CSS puede hacer que el primer párrafo se trate como un abstract
  En cambio, este proyecto parece ir más en la dirección de crear documentos autocontenidos más ricos
  No hay CSS, pero sí muchas opciones de estilo predefinidas, y por eso me recuerda una y otra vez al HTML inicial
  HTML 1 no tenía color ni casi formato, así que se parecía a Markdown, pero para HTML 3 ya había empezado a llenarse de cosas, y este flujo se siente parecido