MDX-formatter
Ryd op i MDX-dokumenter med denne MDX-formatter. Indsæt MDX med imports, exports, JSX-komponenter og Markdown, så fjerner værktøjet dokumentets ydre tomme linjer og justerer alle rørtabeller igen ved at tilpasse cellerne til kolonnebredden og genopbygge separatorrækken med dens justeringskoloner. Imports, komponenter og udtryk forbliver præcis, som de er skrevet, så dokumentationsforfattere får pæne tabeller uden at ødelægge buildet.
Ofte stillede spørgsmål
Hvad ændrer MDX-formatter?
Den justerer rørtabeller igen og fjerner tomme linjer og mellemrum fra begyndelsen og slutningen af dokumentet. Alt andet, herunder Markdown-tekst, imports, exports og JSX, bevares præcis, som det er skrevet.
Berøres imports, exports og JSX-komponenter?
Nej, import- og export-sætninger, komponenttags som <Callout type="info"> og udtryk i krøllede parenteser kopieres uændret. Formatteren ombryder aldrig kode, så den kan ikke ødelægge dit MDX-build.
Hvordan formateres tabeller?
Hver række får indledende og afsluttende lodrette streger, og hver celle får mellemrum, så den passer til den bredeste celle i kolonnen, dog mindst tre tegn. Separatorrækken bygges op igen med tilsvarende bindestreger.
Bevares tabeljusteringer?
Ja, justeringskoloner i separatorrækken, såsom :---, :---: og ---:, bevares. Venstre-, centrerede og højrejusterede kolonner vises på samme måde efter formatering.
Ændres kodeblokke?
Nej, indhold mellem afgrænsninger med tre backticks eller tre tilder forbliver, som det er. Linjer med lodrette streger inde i kodeblokke behandles aldrig som tabeller.
Hvorfor er nogle tabelkolonner bredere end forventet?
Bredder tælles i UTF-8-bytes, så bogstaver med accent og emoji tæller som mere end ét tegn. Den ekstra afstand ses kun i kilden; den viste tabel ser ens ud.
Formaterer den JavaScript inde i min MDX?
Nej, kode i imports, exports og udtryk omformateres ikke. Formatér større kodeblokke separat med JavaScript- eller JSX-formatter.
Hvad er forskellen fra Markdown-formatter?
Begge anvender de samme regler; dette værktøj markerer resultatet som mdx. Brug det til .mdx-filer i Docusaurus, Next.js, Astro eller lignende dokumentationsopsætninger.
Hvorfor er resultatet omgivet af en mdx-kodeblok?
Outputtet returneres i en kodeblok markeret mdx, så det vises som kildekode, når det indsættes i Markdown. Kopiér linjerne mellem de ydre afgrænsninger ind i din .mdx-fil.
Hvor stort må mit dokument være?
Op til 5 MB pr. kørsel; større input afvises med en besked. Outputtet er identisk med MDX-indstillingen i Code Formatter.