MDX format (.mdx)

MDX-formatet leser .mdx-filer – CommonMark Markdown utvidet med JSX-komponenter, ESM import/export-setninger og {expression}-klammeparenteser. Det er forfatterformatet til moderne dokumentasjons- og innholdssider (Docusaurus, Next.js, Astro).

Markdown-prosa som skal oversettes, trekkes ut med samme maskineri og konfigurasjon som Markdown-formatet (avsnitt, overskrifter, listeelementer, lenke- og bildetekst, innebygd formatering). MDX-spesifikke konstruksjoner (ESM-setninger, JSX-tagger med attributter og barn, {expression}-blokker på toppnivå og GFM-tabeller) bevares byte-for-byte og oversettes aldri – komponentnavn, attributtverdier, importstier og uttrykk forblir urørte. Les→skriv reproduserer virkelige .mdx-filer nøyaktig når ingenting er oversatt; leseren selvverifiserer hver prosaregion og faller tilbake til ugjennomsiktig bevaring dersom en region ikke ville overleve en byte-tro rundtur.

IDmdx

SourceBuilt-in

Extensions.mdx

MIME Typestext/mdx

CapabilitiesRead + Write

Parameters

Parameter	Type	Default	Description
`codeFinderRules`	array		Regex-mønstre som matcher innebygde koder i oversettbar tekst.
`extractNonTranslatableContent`	boolean	true	Hvis true, vises MDX-spesifikt ikke-oversettbart innhold (JSX-tekstbarn på blokknivå, GFM-tabellcelleprose og markdown-spenn som ikke kan rekonstrueres trofast) som ikke-oversettbare innholdsblokker (synlige for innhenting, hoppes over av MT) samtidig som de forblir byte-tro ved rundtur. Hvis false, forblir disse konstruksjonene ugjennomsiktige.
`frontMatterKeys`	array		Frontmatternøkler som skal ekstraheres når translateFrontMatter er på (tom = hver skalarverdi). Angi nøklene med prosainnhold, f.eks. title og description.
`translateBlockQuotes`	boolean	true	Hvis sann, er blokksitatinnhold oversettbart.
`translateCodeBlocks`	boolean	false	Hvis sann, er avgrensede og innrykket kodeblokker oversettbare. Hvis usann, sendes de ut som ikke-oversettbare data.
`translateFrontMatter`	boolean	false	Hvis sann, er YAML front matter-verdier oversettbare. Hvis usann, sendes de ut som ikke-oversettbare data.
`translateHTMLBlocks`	boolean	false	Hvis true, er rå HTML-blokker oversettbare. Hvis false, emitteres de som ikke-oversettbare data.
`translateImageAlt`	boolean	true	Hvis sann, inkluderes alt-tekst for bilder i oversettbart innhold.
`translateURLs`	boolean	false	Hvis sann, er lenke- og bilde-URL-er oversettbare.
`useCodeFinder`	boolean	false	Aktiver regex-basert deteksjon av innebygd kode i oversettbar tekst.

Configure it live

Configuration

Loading form…

Processing notes

Markdown-prosa er oversettbar; ESM, JSX (inkludert barn, i denne versjonen), uttrykk og GFM-tabeller er ugjennomsiktige og bevares ordrett.
Konfigurasjonsparametere speiler Markdown-formatet (f.eks. håndtering av frontmatter og kodeblokker).
Gjenkjenning skjer via den unike .mdx-utvidelsen.

← Back to the Format Reference