翻訳

MarkdownおよびMDXドキュメントを翻訳

ドキュメントはキーのリストではありません。そのテキストは、コードブロック、リンク、フロントマターに散らばっており、それらは正確に戻ってくる必要があります。KAERISはファイルを保護された断片と本文に分割し、本文のみを翻訳し、断片を元に戻します。

KAERISはこのページを翻訳し、すべての行を逆翻訳して確認しました。ネイティブスピーカーによるレビューはまだ行われていません。 英語原文

ファイルを翻訳する ファイルを無料でチェックする

Markdownドキュメントの読み取り方法

ドキュメントは、リテラルの断片と番号付きのテキストセグメントのスケルトンに分割されます。セグメント内では、インラインコード、リンクターゲット、HTML、JSXタグは、翻訳前に{0}のようなトークンに置き換えられ、後に復元されます。トークンを1つでもドロップするモデルは、ドロップされた変数と同じ検出器をトリップします。

ソースファイルgetting-started.md
---
title: Getting started
slug: getting-started
---

# Getting started

Install the package with `pip install kaeris`, then read the [CLI guide](/docs/cli).

```bash
kaeris translate en.json --langs de,ja
```

Run it once per release. It only translates new keys.

Markdown翻訳で注意すべきこと

実際の実行、実行前と実行後

実際の実行：テストドキュメント、ドイツ語、2026年10月26日、先頭と1つのコードブロックにカット。見出し、太字テキスト、curlコマンド、およびトークン$TOKENはソースと同じです。本文と読者が目にするフロントマターフィールドのみが変更されました。

翻訳前help-returns.md
---
title: Returns and refunds
summary: How to return a record, and when you will not get a refund.
---

# Returns and refunds

You can return an unopened record within **30 days** of delivery. We refund the full price, but not the shipping cost.

…
```bash
curl https://api.example.com/v1/returns/RT-1042 -H "Authorization: Bearer $TOKEN"
```
翻訳後de/help-returns.md
---
title: Rücksendungen und Erstattungen
summary: So senden Sie eine Schallplatte zurück und wann Sie keine Erstattung erhalten.
---

# Rücksendungen und Erstattungen

Sie können eine ungeöffnete Schallplatte innerhalb von **30 Tagen** nach Lieferung zurücksenden. Wir erstatten den vollen Preis, jedoch nicht die Versandkosten.

…
```bash
curl https://api.example.com/v1/returns/RT-1042 -H "Authorization: Bearer $TOKEN"
```

KAERIS が行うこと

ファイルを翻訳する ファイルを無料でチェックする

3ステップで実行する

  1. CLIをインストールする

    pip install kaerisを実行します。

  2. ドキュメントを翻訳

    kaeris translate docs/guide.md --langs de,jaを実行します。docs/*.mdのようなグロブは複数のファイルを翻訳します。

  3. 読み返す

    --verify実行からのverify.jsonを開いて、各翻訳された部分があなたの言語で現在何を言っているかを確認します。

pip install kaeris
kaeris translate docs/guide.md --langs de,ja --verify

よくある質問

ドキュメント内のコードは翻訳されますか？

いいえ。フェンス付きおよびインデントされたコードブロック、インラインコード、URL、HTMLおよびJSXタグはバイト単位でそのまま返されます。

MDXコンポーネントは翻訳されますか？

散文部分とその周囲の単一行部分は翻訳されます。複数行のJSXコンポーネント内のテキストは、フォーマットリーダーの制限により翻訳されず保持されます。

無料ですか？

はい、アカウントなしで：ファイルあたり 10,000 文字、実行あたり最大 8 言語。無料の API キーでファイル制限が 50,000 文字に引き上げられます。一度限りの生涯プランは 79 ドルで、ご自身の OpenRouter キーを使用します。月額プランは 19 ドルから。 料金

ターミナルや CI から実行できますか？

はい。pip install kaerisを実行し、次にkaeris translate docs/guide.md --langs de,jaを実行します。GitHub Actionはプルリクエスト内で同じ翻訳を実行します。CLIドキュメント · GitHub Action

続ける

CLIリファレンス · チェックリファレンス · ブラウザで翻訳 · 無料チェック · フォーマット変換 · 疑似ローカリゼーション

その他のフォーマット: JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · CSV · Fluent · Android XML