Quarkdown - Markdown com recursos avançados

• Combina a escrita de documentos baseada em Markdown com recursos de composição tipográfica no nível do LaTeX, permitindo tratar em uma única ferramenta desde artigos acadêmicos até livros, apresentações, sites estáticos e bases de conhecimento
• Em uma sintaxe com menos boilerplate, é possível inserir diretamente elementos como autor, margens, resumo, imagens e citações, escrevendo conteúdo e layout juntos
• Com uma linha de configuração .doctype, alterna entre os tipos de documento paged, plain, docs e slides, com suporte até a apresentações interativas
• Oferece compilação rápida e preview ao vivo e, com scripting Turing complete, permite reutilizar funções e argumentos para reduzir trabalho repetitivo de layout
• É disponibilizado como open source gratuito, tem mais de 10 mil stars no GitHub, integração com VS Code e também Quickstart e documentação, ampliando os caminhos de uso real e expansão

---

Principais características

• Um sistema moderno de criação de documentos que combina Markdown com recursos de composição tipográfica no nível do LaTeX
• Estruturado para permitir tratar, em uma única ferramenta, desde artigos acadêmicos, livros e apresentações até sites estáticos e bases de conhecimento
• Gratuito e disponibilizado como open source, com o compilador em evolução contínua e mantido como software livre
• Quarkdown, Wiki, Discuss

Experiência de escrita

• Projetado para permitir foco na escrita sem boilerplate
• Elementos como docauthor, pagemargin, abstract, imagens e citações podem ser inseridos diretamente na sintaxe, permitindo trabalhar juntos o layout do documento e o conteúdo
• O documento de exemplo é estruturado em um fluxo em que título, autor, margens, imagens, resumo e citações são escritos juntos em um único arquivo
• A sintaxe estendida permite mais formas de expressão do que o Markdown básico

Tipos de documento e doctype

• O tipo de documento é alternado com uma linha da configuração .doctype
• paged é usado para artigos, livros e relatórios
• plain é usado para notas, bases de conhecimento e sites estáticos simples
• docs é usado para wikis, documentação técnica e grandes bases de conhecimento
• slides é usado para aulas, palestras e apresentações interativas

Preview responsivo e scripting

• Com compilação rápida e preview ao vivo, é possível verificar o resultado imediatamente enquanto se digita
• Inclui um recurso de scripting Turing complete para reduzir trabalho repetitivo
• Com definição de funções e reutilização de argumentos, é possível aplicar o mesmo padrão de layout a vários itens
• No exemplo, após definir a função animal, reutilizam-se nome, ecossistema e composição da imagem para gerar vários itens

Instalação e caminho inicial

• A seção de instalação indica que a v2.0.0 foi lançada em 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 →

Ecossistema e materiais

• Indicado como tendo mais de 10 mil stars no GitHub
• Oferece caminhos para aprendizado e integração com editor por meio de Quickstart, Docs, VS Code e Wiki

[GN⁺]

Comentários do Hacker News

• Sinceramente, é impressionante, mas para mim a essência do Markdown está na simplicidade extrema
  Dá para editar sem GUI, escrever no VIM do terminal já tendo uma boa noção de como o resultado vai ficar, e o próprio arquivo .md cru já é agradável de ler
  Mas, quando você começa a empilhar recursos em cima disso, passa a ter que ficar procurando comandos desconhecidos, no fim não lembra deles, e sem renderização já não tem mais certeza de como vai parecer, então acaba desejando um editor WYSIWYG
  Parece uma ideia parecida com querer colocar teclas cirílicas, devanágari, chinesas e árabes todas num teclado QWERTY, e aí no fim dá a sensação de voltar para o hunt and peck

  • Para mim, uma das grandes vantagens do Markdown é ser meio WYSIWYG
    A sintaxe básica reaproveita formas que as pessoas já usavam para imitar formatação em texto, então o que você digita em geral continua legível por si só
    Mesmo sem conhecer exatamente a sintaxe de Markdown, normalmente dá para ler sem problema; tabelas parecem tabelas e parágrafos parecem parágrafos
    De vez em quando preciso consultar a sintaxe de novo, mas tudo bem. É natural que o vocabulário passivo seja maior que o ativo
    Por isso eu costumo julgar pela legibilidade do texto de entrada, e muita coisa mostrada aqui não parece trazer um ganho tão grande nesse critério
    Dito isso, não vi exemplos de formatação de fórmulas, e os raros casos em que uso LaTeX normalmente são justamente por causa de matemática que Markdown não resolve, então fico curioso para ver como isso fica na prática
  • Esse argumento é bem convincente
    Ainda assim, o Quarkdown claramente parece uma evolução em relação a escrever LaTeX na mão, e também parece oferecer melhor previsibilidade do resultado e melhor compatibilidade com edição assistida por LLM do que editores GUI tipo Word
  • É só fazer um Quarkdown ainda mais poderoso, sem precisar decorar comandos novos estranhos e com uma UI/UX polida
    O nome pode ser Microsoft Word
  • Eu também estou fazendo um pequeno renderizador de Markdown, e até dar um nome já é difícil, enquanto fazer as pessoas usarem depois de pronto é mais difícil ainda
    Hoje em dia, só um editor comum de "plain markdown" dificilmente chama atenção, e para chegar à primeira página do HN parece que no fim é preciso ter funcionalidade e acabamento que vão além do Markdown tradicional
    Parece uma espécie de seleção natural
  • Obsidian.md é realmente excelente como editor WYSIWYG para Markdown básico

• Seria bom ter um material comparando essas ferramentas e linguagens de marcação de uma vez só
  Seria legal ver MyST, Pandoc, Quarkdown, Quarto e Typst lado a lado
  Quarto e Pandoc usam Pandoc Markdown, e https://www.zettlr.com/ também
  Já Quarkdown e Typst passam mais a sensação de linguagens de marcação programáveis, mais próximas de LaTeX ou HTML+Javascript, então ainda não parece decidido quem vai ser o verdadeiro sucessor do LaTeX

  • Já usei a maioria deles e pretendo continuar usando, e eu separaria mais ou menos assim
    Markdown é basicamente um .txt com um pouco de açúcar sintático, que pode ser exportado para PDF ou HTML
    Quarto é Markdown quando você quer executar blocos de código
    Typst é um LaTeX refeito de forma moderna, então ele corta 90% das coisas aleatórias, mas também parece perder uns 10% das funcionalidades
    A academia já tende a não gostar de novidade, então mesmo usando Typst é bem possível que a recepção não seja das melhores
    Pandoc no fim é uma ferramenta para exportar para vários formatos, como PDF e HTML
    Em geral fica fácil perceber de que lado está a ferramenta de que você precisa; até existe asciidoc e afins, mas se você pensar no que não é coberto pelo conjunto markdown/quarto/typst, não sobra muita coisa
    O que realmente resta, se muito, são editores WYSIWYG
  • djot também valeria entrar na comparação
    Parece um superset de Markdown bem projetado e bastante criterioso
    https://djot.net/
  • Eu queria muito gostar de Typst
    Seria ótimo não precisar mais usar LaTeX, mas quando tentei aplicar em projetos reais encontrei casos de borda demais e acabei voltando para o LaTeX
    Há coisas do LaTeX que ainda faltam nele, e a falta de convertibilidade com Pandoc também pesou bastante
    Torço muito para que esses 10% finais sejam preenchidos
  • Se é esse tipo de comparação que você quer dizer, ela já existe
    https://github.com/iamgio/quarkdown#comparison
  • Pandoc está em outra camada em relação às outras ferramentas
    Você pode aplicar filtros arbitrários sobre o formato JSON intermediário, então dá para implementar praticamente qualquer transformação que quiser, e ele converte vários formatos para esse JSON e também no sentido contrário
    Por isso eu prefiro sistemas baseados em Pandoc, e muitas vezes coisas que a ferramenta padrão não faz acabam sendo resolvidas com um simples inline filter

• Segundo o modelo padrão do software de física, se você editar Quarkdown no Atom ele vira Quarkup, e você precisa trocar o Neutron Mail por Proton Mail
  Só funciona, porém, se você digitar com a mão esquerda enquanto cria um app em Electron e ainda escrever um anti-Neutrinos AI blogpost

• Minha avaliação curta é que isso, na prática, está mais para um Markdown com macros no estilo LaTeX
  Só que aqui eles chamam isso de funções, talvez porque exista pelo menos uma função com efeitos colaterais: a função que define novas funções
  Gosto da pureza sintática de "tudo é função", mas misturar estrutura e estilização de um jeito natural, à la HTML/CSS, me deixa um pouco dividido. Embora, claro, essa fronteira já fosse meio nebulosa desde sempre
  Ainda assim, é bem legal, e eu entendo por que há tanta reação cética a tentativas de mexer muito no Markdown
  Também é válida a crítica de que abusar de funções pode prejudicar a legibilidade do texto-fonte, e às vezes a incompletude de Turing é uma vantagem
  Mas, olhando apenas para o projeto de adicionar funções ao Markdown, acho que isso entra na categoria de design bem limpo

• Eu sou o autor e líder do projeto Quarkdown
  No começo isso era um projeto de pesquisa da faculdade, e eu jamais imaginaria que dois anos depois estaria assim
  Obrigado pelo interesse; vou tentar responder ao máximo de comentários possível

  • Queria saber se há planos de "corrigir" a sintaxe de negrito no v3
    Sempre achei que **bold** e *italic* fazem menos sentido do que *bold* e _italic_
    Esse asterisco extra do Markdown é um design ruim e, principalmente ao editar Markdown em celular ou tablet, é bem incômodo
  • A ideia de colocar funções num formato de texto parece bem incomum
    Mesmo em documentos GUI, macros geralmente são evitadas, então fiquei curioso se o Quarkdown foi pensado desde o início para documentos complexos e repetitivos
    Obrigado por abrir espaço para perguntas
  • Li https://iamgio.eu/2025-12-10-accidentally-in-silicon-valley/ e fiquei feliz de ver que parece ter dado tudo certo

• Dando uma olhada na documentação, fiquei um pouco preocupado se o modelo de avaliação é o mais adequado para esse trabalho
  Em layout de texto, normalmente ao ajustar uma parte você desorganiza a posição de outras, então precisa rodar novas passagens de layout, ou seja, uma estrutura que itera até um ponto fixo
  O Typst tem o conceito de context para isso https://typst.app/docs/reference/context/, e não vi algo parecido no Quarkdown. Posso ter deixado passar
  Eu troquei a combinação pandoc/md/LaTeX por Typst no meu trabalho com livros e estou bem satisfeito
  Gosto da sensação de programar numa linguagem moderna, e a velocidade também é muito melhor que pandoc+LaTeX
  https://functionalprogrammingstrategies.com/

• Vendo pelo lado do AsciiDoc, o design de sintaxe do Quarkdown parece limpo, e especialmente as funções definidas pelo usuário são interessantes
  Mas sinto que a parte mais difícil nesse tipo de ferramenta não é tanto a linguagem-fonte em si, e sim o pipeline de saída
  Extensões de Markdown como referências cruzadas, admonition, conteúdo condicional e reutilização baseada em funções são, em termos de design, totalmente tratáveis
  A parede de verdade vem depois: por exemplo, tagged PDF compatível com PDF/UA, builds determinísticos que não oscilem entre ambientes, hreflang e cross-document linking em sites multilíngues, ou incremental rebuild que aguente até livros de 500 páginas
  Especialmente na UE, depois que o European Accessibility Act entrou em vigor em 28 de junho de 2025, a importância de PDF/UA ficou ainda maior
  Fico curioso sobre como vocês pretendem conduzir os quatro doctypes, especialmente o lado paged

• MyST também deveria entrar na tabela de comparação
  https://mystmd.org/
  Parece bem possível que isso venha a ser o novo padrão de Markdown no futuro

  • Ou então Typst também valeria incluir
    Não é uma extensão de Markdown, mas os objetivos e casos de uso são bem parecidos
  • A combinação MyST + Sphinx é muito boa
    Só sinto falta de um suporte forte a LSP, e pelo menos eu não consegui fazer isso funcionar direito no helix
    Meu blog também foi feito com pydata-sphinx-theme e myst
  • Não conheço muito bem esse lado
    Se quiser, pode atualizar a tabela você mesmo com um PR

• No meu app, adotei uma abordagem um pouco diferente
  Foquei em legibilidade e em facilitar o trabalho com diagramas grandes em Mermaid, e recentemente também adicionei um modo de tela cheia para navegar como se fosse um mapa
  https://mdview.io/s/97af684b

• Quando uso SSG, prefiro manter a entrada no Markdown mais limpo possível e deixar os detalhes de formatação concentrados no CSS
  Por exemplo, não precisa usar algo como .abstract; basta fazer o CSS tratar o primeiro parágrafo como abstract
  Já este projeto parece seguir mais na direção de documentos autossuficientes e mais ricos
  Não há CSS, mas há muitas opções de estilização predefinidas, e por isso ele continua me lembrando o HTML antigo
  O HTML 1 não tinha cores nem quase nenhuma formatação, então era parecido com Markdown; lá pelo HTML 3 começou a ganhar de tudo um pouco, e isso parece seguir um fluxo semelhante