MDX format (.mdx)

The MDX format reads .mdx files, CommonMark Markdown extended with JSX components, ESM import/export statements, and {expression} braces. It is the authoring format of modern documentation and content sites (Docusaurus, Next.js, Astro).

Translatable Markdown prose is extracted using the same machinery and configuration as the Markdown format (paragraphs, headings, list items, link/image text, inline emphasis). MDX-specific constructs (ESM statements, JSX tags with their attributes and children, top-level {expression} blocks, and GFM tables) are preserved byte-for-byte and never translated, with component names, attribute values, import paths, and expressions left untouched. Read→write reproduces real-world .mdx exactly when nothing is translated; the reader self-verifies each prose region and falls back to opaque preservation if a region would not round-trip byte-faithfully.

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 sann, er rå HTML-blokker oversettbare. Hvis usann, sendes de ut som ikke-oversettbare data.
translateImageAlt	boolean	true	Hvis sann, inkluderes alt-tekst for bilder i det oversettbare innholdet.
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…

Configuration output

vs defaults no changes

apiVersion: neokapi/v1
kind: MdxFormatConfig
metadata:
  name: mdx
spec:
  # (default configuration)

Processing notes

• Markdown prose is translatable; ESM, JSX (including children, in this version), expressions, and GFM tables are opaque and preserved verbatim.

• Configuration parameters mirror the Markdown format (e.g. frontmatter and code-block handling).

• Detection is by the unique .mdx extension.

← Back to the Format Reference