Quarkdown 2.0.0 - Markdown com recursos poderosos
(quarkdown.com)- Combina escrita de documentos baseada em Markdown com recursos de composição tipográfica no nível do LaTeX, permitindo criar com 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 ao mesmo tempo
- Com uma linha de configuração
.doctype, é possível alternar entre os tipos de documentopaged,plain,docseslides, com suporte até para apresentações interativas - Oferece compilação rápida e preview ao vivo, e com scripting Turing complete é possível reutilizar funções e argumentos para reduzir trabalho repetitivo de layout
- Disponível gratuitamente como código aberto, com o compilador em evolução contínua e mantido como software livre
Mudanças da versão 2.0.0: lançada em 23 de abril de 2026
- A saída HTML passou a ser totalmente offline, reduzindo bastante problemas de estilo quebrado e recursos ausentes causados pela dependência de CDN e Google Fonts
- Foi adicionado um novo sistema de permissões, permitindo controlar com
--allowe--denyo escopo que o documento pode acessar durante a compilação; sem permissão, um erro é gerado imediatamente, aumentando a segurança - O diretório de saída padrão mudou de
./outputpara./quarkdown-output, então workflows que dependiam do caminho padrão anterior precisam de ajuste - Ao usar
--preview, o nome de saída padrão não é mais baseado em.docname, e passou para o formatopreview-<mainfile>-<hash>, aumentando a estabilidade do preview - Foi introduzida a renderização paralela, melhorando o desempenho de renderização em documentos grandes ao processar elementos irmãos simultaneamente
- O diretório
public/na raiz do projeto pode ser copiado diretamente para a raiz do resultado HTML, facilitando a distribuição derobots.txt,CNAMEe ativos estáticos compartilhados - Com a nova função
.htmloptions, ao definirbaseurlé possível inserir canonical links em cada página e também gerarsitemap.xml, melhorando a compatibilidade com mecanismos de busca - Na compilação HTML, links e imagens agora oferecem suporte ao símbolo de caminho raiz
@, permitindo referenciar ativos compartilhados de forma consistente a partir de qualquer subdocumento - Foi adicionada a nova função primitiva
.image, permitindo controle detalhado de tamanho, legenda e uso de caminho relativo fixo, além de funcionar bem com ativos depublic/ - Agora há suporte a links de referência cruzada para todos os elementos referenciáveis, permitindo navegação por clique em figuras, tabelas, blocos de código, fórmulas e blocos numerados definidos pelo usuário
- O nome do módulo da biblioteca padrão
Injectionmudou paraHtml, então documentos existentes ou códigos de referência precisam ser atualizados - Também foram corrigidos o clarão branco no preview ao vivo com tema escuro e o problema dos links da wiki do Quarkdoc, melhorando a experiência de uso
1 comentários
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
.mdcru já é agradável de lerMas, 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
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
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
O nome pode ser Microsoft Word
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
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
Markdown é basicamente um
.txtcom um pouco de açúcar sintático, que pode ser exportado para PDF ou HTMLQuarto é 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
Parece um superset de Markdown bem projetado e bastante criterioso
https://djot.net/
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
https://github.com/iamgio/quarkdown#comparison
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
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
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
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
Não é uma extensão de Markdown, mas os objetivos e casos de uso são bem parecidos
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
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 abstractJá 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