Vitrine completa

§1.1Marcas inline

A análise de ênfase é amigável a CJK: o negrito fecha mesmo encostado em pontuação chinesa — **报文。**同时 renderiza como 报文。同时, e não como asteriscos literais. Itálico, tachado e código inline funcionam como de costume; com a chave gemoji, um atalho como :sparkles: renderiza como ✨. Caracteres dentro de código inline não participam de análise nenhuma, então as crases são o jeito seguro de mostrar sintaxe: **, $…$ e > [!note] aparecem todos ao pé da letra. Para exibir um asterisco no texto corrido, escape-o — *assim* continua texto comum.

§1.2Wikilinks

Com a chave wikilinks ligada, links [[de colchetes duplos]] resolvem contra a coleção de notas do jeito que um wiki espera: por id (design-tokens — partindo de uma página espelho em português, o resolvedor prefere o espelho no mesmo idioma e só cai no original em inglês quando a nota não existe aqui), por alias (boundaries chega à nota cujo id é three-way-split), com rótulo (o guia de primeiros passos). Um alvo que não resolve para nada renderiza como link morto marcado, em vez de derrubar o build — e o CLI check-wikilinks do motor o relata no CI, que é onde apodrecimento de link pertence.

§1.3Tabelas: rolagem quando largas, cartões quando estreitas

Uma tabela de seis ou mais colunas deve refluir para um cartão por linha num contêiner estreito, em vez de espremer cada célula a dois caracteres. Esta tabela de sete colunas é ao mesmo tempo o guia rápido das variantes de callout e um teste vivo desse refluxo (encolha a janela até a largura de um celular):

Os títulos padrão são em inglês; um site troca o conjunto inteiro pela opção calloutLabels do siteMarkdown, por exemplo calloutLabels: { tip: 'Intuição', warn: 'Aviso' }. Um título escrito na sintaxe de citação (> [!tip] Meu título) sempre vence.

§2.1Callouts: três grafias

Primeira, a sintaxe de citação do Obsidian/GitHub (disponível com callouts: true, funciona também em arquivos Markdown puros):

O marcador de dobra do Obsidian é honrado — > [!note]- renderiza recolhido, > [!note]+ aberto:

Segunda, o componente do pacote em MDX (astro-inkstone/components/Callout.astro, importado por caminho). Sem um title, ele exibe o rótulo padrão da variante, o mesmo que a sintaxe de citação usa:

Terceira, HTML cru, as seis variantes de uma vez (casando uma a uma com as regras .callout do base.css):

§2.2Matemática

Fórmulas inline assentam no texto: a profundidade óptica se escreve $\tau = \int \kappa \rho \, \mathrm{d}s$. Matemática em destaque usa a forma de três linhas ($$ em linhas próprias) — o guardião rejeita a forma de linha única, que renderizaria em silêncio como uma pequena fórmula inline:

O fundo de fórmula é, de propósito, um papel diferente do corpo, e troca junto com o tema. Aliás, escape preços em dólar no texto corrido: este café custa $3.

§3.1Molduras de código

Uma cerca com title="…" ganha uma barra de título com o nome do arquivo; o botão de copiar no canto vale para o site inteiro. As anotações de linha [!code ++] / [!code --] renderizam como fundos de diff:

def build_pipeline(opts):
    plugins = [remark_math]  
    plugins = [remark_gemoji, remark_math]  
    return assemble(plugins, guard=opts.guard)

Uma moldura marcada com collapse começa dobrada e só ocupa espaço quando aberta — certa para arquivos de configuração longos:

site:
  markdown:
    numbering: chapters
    math: true
    codeFrame: true
    mermaid: true
    callouts: true
    wikilinks: true
  styles:
    - astro-inkstone/styles/tokens.css
    - astro-inkstone/styles/base.css

O realce nos dois temas vem do shiki emitindo os dois conjuntos de cores de uma vez; o base.css escolhe um por data-theme num lugar só — sem cabo de guerra de especificidade.

§3.2Diagramas mermaid

Uma cerca ```mermaid deixa apenas um marcador de posição no build; o renderizador carrega dinamicamente só nas páginas que trazem um diagrama (as demais não pagam nada) e re-renderiza quando o tema vira:

flowchart LR
  A["astro-inkbrush<br/>motor: edição / dialeto / guardião"] --> C["seu site<br/>identidade / rotas / deploy"]
  B["astro-inkstone<br/>papel: tokens / estilos / pipeline"] --> C
  A -. um dialeto compartilhado .-> B

§3.3Extras do GFM

Listas de tarefas e notas de rodapé vêm de carona com o GFM:

• tokens importados
• base.css importado
• paleta de identidade sobrescrita

Uma afirmação que merece fonte ganha uma nota de rodapé.¹

§4.1O que o guardião rejeita nesta página

Que esta página compile é, por si só, a demonstração de que tudo acima está bem formado. Estas grafias derrubariam o build na hora (experimente uma e rode npm run build):

• uma marca de ênfase sem par, como um ** deixado aberto no fim da linha;
• $$x$$ em linha única (use a forma de três linhas);
• títulos numerados à mão — escrever o título desta seção como ## 9. O que o guardião… colidiria com a numeração de build e seria sinalizado;
• o MDX avaliando as chaves da sua prosa: {0,1,2,3} renderizaria como um mero 3, então o guardião exige a forma escapada {0,1,2,3};
• uma fórmula que o KaTeX não consegue renderizar (o guardião re-renderiza cada fórmula em modo estrito, em vez de deixar texto vermelho de erro chegar à página).