# gt: General Translation CLI tool: MDX と Markdown
URL: https://generaltranslation.com/ja/docs/cli/reference/formats/mdx-md-files.mdx
---

title: MDX と Markdown
description: General Translation CLI で MDX ファイルと Markdown ファイルを翻訳します。MDX および Markdown ファイル形式の API リファレンスです。

---

CLI は MDX (`mdx`) ファイルと Markdown (`md`) ファイルを翻訳します。ソースファイル内のすべての構文と書式は、翻訳後でもそのまま保持されます。

## 設定 [#config]

`files` の下に、glob パターンを指定した `include` 配列を持つ `mdx` または `md` のエントリを追加します。CLI がソースファイルを見つけて翻訳を正しいパスに保存できるよう、`[locale]` プレースホルダーを使用してください。

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["ja"],
  "files": {
    "mdx": {
      "include": ["content/docs/[locale]/**/*.mdx"],
      "transform": "*.[locale].mdx"
    }
  }
}
```

これにより、`content/docs/en` 配下のすべての MDX ファイルが翻訳され、結果は `content/docs/ja` に保存されます。Markdown ファイルには、代わりに `md` キーを使用してください。すべてのファイルキーについては、[設定リファレンス](/docs/cli/reference/config#files)を参照してください。

## 翻訳済みファイル名の変更 [#transform]

`transform` キーは、出力ファイル名を再マッピングします。上の例では、`*.[locale].mdx` によって翻訳後の拡張子が `.ja.mdx` に変わります。これは、ドキュメントフレームワークがディレクトリパスではなくファイル名にロケールを含めることを前提としている場合に使用します。

## リンクとアセットをローカライズする [#localize]

いくつかの実験的な [`gt translate`](/docs/cli/reference/commands/translate#experimental) フラグは、`md` および `mdx` の出力にのみ適用されます。

* `--experimental-localize-static-urls` — 翻訳後内の URL をローカライズします。
* `--experimental-localize-static-imports` — 翻訳後内の静的インポートをローカライズします。
* `--experimental-localize-relative-assets` — 翻訳後内の相対画像アセット URL を書き換えます。
* `--experimental-hide-default-locale` — ローカライズされたパスからデフォルトロケールを非表示にします。