Formatador de MDX
Organize documentos MDX com este formatador de MDX. Cole MDX com imports, exports, componentes JSX e Markdown, e a ferramenta remove as linhas em branco externas do documento e realinha todas as tabelas com barras verticais, ajustando as células à largura das colunas e reconstruindo a linha separadora com os dois-pontos de alinhamento. Imports, componentes e expressões permanecem exatamente como foram escritos, para que autores de documentação tenham tabelas organizadas sem comprometer a compilação.
Perguntas frequentes
O que o Formatador de MDX altera?
Ele realinha as tabelas com barras verticais e remove linhas em branco e espaços do início e do fim do documento. Todo o restante, incluindo o texto Markdown, imports, exports e JSX, permanece exatamente como foi escrito.
Imports, exports e componentes JSX são alterados?
Não, instruções de import e export, tags de componentes como <Callout type="info"> e expressões entre chaves são copiadas sem alterações. O formatador nunca reorganiza o código, então não pode comprometer a compilação do seu projeto MDX.
Como as tabelas são formatadas?
Cada linha recebe barras verticais no início e no fim, e cada célula recebe espaços até a largura da célula mais larga da coluna, com no mínimo três caracteres. A linha separadora é reconstruída com traços correspondentes.
Os alinhamentos das tabelas são preservados?
Sim, os dois-pontos de alinhamento na linha separadora, como :---, :---: e ---:, são mantidos. As colunas alinhadas à esquerda, ao centro e à direita são renderizadas da mesma forma após a formatação.
Os blocos de código são alterados?
Não, o conteúdo entre cercas de três crases ou três tis permanece intacto. Linhas com barras verticais dentro de blocos de código nunca são tratadas como tabelas.
Por que algumas colunas da tabela ficam mais largas do que o esperado?
As larguras são contadas em bytes UTF-8, então letras acentuadas e emojis contam como mais de um caractere. O preenchimento extra aparece apenas no código-fonte; a tabela renderizada fica igual.
Ele formata o JavaScript dentro do meu MDX?
Não, o código em imports, exports e expressões não é reformatado. Formate blocos de código maiores separadamente com o JavaScript ou o Formatter de JSX.
Qual é a diferença em relação ao Formatter de Markdown?
Ambos aplicam as mesmas regras; esta ferramenta identifica o resultado como mdx. Use-a para arquivos .mdx no Docusaurus, Next.js, Astro ou em configurações de documentação semelhantes.
Por que o resultado está dentro de um bloco de código mdx?
A saída é retornada dentro de um bloco de código identificado como mdx, para que seja exibida como código-fonte quando colada em Markdown. Copie as linhas entre as cercas externas para o seu arquivo .mdx.
Qual pode ser o tamanho do meu documento?
Até 5 MB por execução; entradas maiores são rejeitadas com uma mensagem. A saída é idêntica à opção MDX do Code Formatter.