Translate MDX files with Hyperlocalise

​

Source file

# Welcome

<Callout type="info">
    Read the setup guide before translating.
</Callout>

​

Configure your files

locales:
    source: en-US
    targets:
        - es-ES

buckets:
    messages:
        files:
            - from: locales/en-US/messages.mdx
              to: locales/{{target}}/messages.mdx

llm:
    profiles:
        default:
            provider: openai
            model: gpt-5.2

​

Translate

hyperlocalise run --dry-run
hyperlocalise run

​

Behavior and limitations

• Uses the MDX parser to translate prose while preserving JSX structure and expressions.
• Frontmatter and fenced code blocks stay unchanged. Keep executable content in expressions or code blocks.
• Review rendered output after translating pages with custom components. Support for MDX does not mean arbitrary component properties are translation messages.

​

Next steps

• Check translations before committing generated files.
• Local translation workflow explains repeat runs.
• Browse all file formats.

​

Related formats

• Markdown
• HTML