Markdownファイルの翻訳方法

Markdownファイルの翻訳は、当社のAI対応ツールで迅速かつ簡単に行えます。以下の手順に従って、ドキュメント、READMEファイル、静的サイトコンテンツの正確でフォーマットを保持した翻訳を取得しましょう。

1. Markdownコンテンツを貼り付け: .mdファイルの内容をコピーし、上記のテキストエリアに貼り付けます。標準Markdown、GitHub Flavored Markdown（GFM）、およびYAMLフロントマター付きMarkdownをサポートしています。
2. ターゲット言語を設定: 翻訳先のISO言語コードを入力します（例: フランス語ならfr、ドイツ語ならde、日本語ならja）。
3. 「翻訳」をクリック: AIがテキストコンテンツを翻訳し、見出し、太字/斜体、リスト、コードブロック、リンク、画像、フロントマターなど、すべてのMarkdown書式を保持します。
4. 結果をコピーまたは保存: 翻訳が完了したら、翻訳されたMarkdownをクリップボードにコピーするか、直接.mdファイルとして保存します。

Markdownとは？なぜ翻訳が必要なのですか？

Markdownは、プレーンテキストをフォーマットされたHTMLに変換する軽量マークアップ言語です。2004年にJohn Gruberによって作成され、世界中のドキュメント、READMEファイル、Wiki、コンテンツ管理システムの標準形式となっています。そのシンプルで読みやすい構文は、テクニカルライター、開発者、コンテンツクリエイターにとって理想的です。

ソフトウェア製品やドキュメントがグローバルな視聴者に届くにつれて、Markdownコンテンツの翻訳が不可欠になっています。READMEファイル、ユーザーガイド、APIドキュメント、ブログ記事をローカライズすることで、異なる言語のユーザーが製品を完全に理解し、使用できるようになります。不適切にローカライズされた、または翻訳されていないドキュメントは、国際的な普及に対する最大の障壁の1つです。

Markdownを手動で翻訳するのはエラーが発生しやすく、書式構文を誤って壊したり、コードブロックを破損したり、リンク構造を損傷したりしがちです。当社のAI対応Markdown翻訳は、すべての構文要素を保持しながら、人間が読めるテキストコンテンツのみを正確に翻訳します。

Markdownの構文と構造

典型的なMarkdownドキュメントには、フォーマットされたテキスト要素が混在しています。当社の翻訳エンジンは、それらすべてを理解し、保持します：

# Getting Started

Welcome to **My Application**! This guide will help you get up and running quickly.

## Installation

Run the following command to install:

```bash
npm install my-application
```

## Features

- Fast and lightweight
- Easy to configure
- Supports multiple languages

> **Note:** Make sure you have Node.js 18 or higher installed.

For more information, see the [documentation](https://example.com/docs).

• 見出し（#, ##, ###）: セクションタイトルは翻訳されますが、見出しレベルのマーカーはそのまま正確に保持されます。
• 太字と斜体（**text**, *text*）: インライン強調マーカーは、翻訳されたテキストの周囲でそのまま維持されます。
• 順序付きおよび順序なしリスト（-, *, 1.）: リストの構造とネストは保持され、リスト項目のテキストのみが翻訳されます。
• コードブロック（```）およびインラインコード（`）: すべてのコードコンテンツは変更されずに保持されます。AIはコード、コマンド、技術的な識別子を翻訳することはありません。
• リンク（[text](url)）および画像（![alt](src)）: URLと画像パスは変更されません。リンクテキストと画像の代替テキストのみが翻訳されます。
• ブロック引用（>）: ブロック引用マーカーは保持され、引用されたテキストコンテンツが翻訳されます。

YAMLフロントマターのサポート

静的サイトジェネレーター（Jekyll、Hugo、Docusaurus、Gatsby）で使用される多くのMarkdownファイルには、---で区切られたファイル上部のメタデータであるYAMLフロントマターが含まれています。当社のAIはフロントマターをインテリジェントに処理します：

---
title: "User Guide"
description: "Complete guide for using our application"
lang: en
sidebar_label: "User Guide"
---

# User Guide

This page explains how to use the core features of our application.

## Quick Start

1. Open the application
2. Sign in with your account
3. Select your preferred language from the settings

## Support

If you need help, please visit our [support page](https://example.com/support)
or contact us at support@example.com.

<code>title</code>、<code>description</code>、<code>sidebar_label</code>などの翻訳可能な値は翻訳されますが、<code>date</code>、<code>slug</code>、<code>lang</code>、<code>draft</code>、<code>weight</code>などの技術的なキーは変更されません。これにより、翻訳されたMarkdownファイルが静的サイトジェネレーターやCMSと即座に互換性を持つことが保証されます。

ソフトウェアローカリゼーションにおけるMarkdown

Markdownは、ソフトウェアローカリゼーションにおける一級市民となっています。ドキュメント・アズ・コードの慣行が広まるにつれ、チームはソースコードと一緒にGitリポジトリにドキュメントを保存するようになり、Markdownが選ばれる形式となっています。このドキュメントをローカライズするには、UI文字列をローカライズするのと同じ厳密さが求められます。

モダンなローカリゼーションプラットフォームは、XLIFF、PO、JSONといった従来の形式と並んでMarkdownをますますサポートするようになっています。GitHubリポジトリ、ドキュメントWebサイト、ナレッジベースのいずれをローカライズする場合でも、Markdown翻訳は現在、国際化ワークフローの核心的な部分となっています。

静的サイトジェネレーターのためのMarkdownローカリゼーション

静的サイトジェネレーターは、多言語コンテンツのためにフロントマター付きのMarkdownファイルに依存しています。各言語は通常、独自の翻訳済みMarkdownファイルディレクトリを持っています：

• Jekyll: _postsおよびコンテンツディレクトリで、言語ごとのフォルダーまたは言語固有のフロントマターを使用します。Jekyllのjekyll-multiple-languages-pluginおよびjekyll-polyglotが多言語Markdownページを管理します。
• Hugo: 言語固有のディレクトリ（content/en/, content/fr/）またはファイル名に言語コードを追加すること（about.fr.md）でコンテンツ翻訳をサポートします。Hugoの組み込み多言語モードは、ドキュメントサイトやマーケティングサイトで広く使用されています。
• Docusaurus: FacebookのDocusaurusは、翻訳されたMarkdownページ用に専用のi18n/フォルダーを使用し、各言語で同じファイル構造がミラーリングされます。DocusaurusのMarkdownファイルを翻訳することは、Markdownローカリゼーションの最も一般的な使用例の1つです。
• Gatsby: Gatsbyサイトはgatsby-plugin-i18nのようなプラグインを使用し、翻訳されたコンテンツを言語やスラッグを指定するフロントマターとともに、ロケールごとに個別のMarkdownファイルとして保存します。
• VitePress: VueのVitePressドキュメントフレームワークは、翻訳されたMarkdownファイルに対して言語別のサブディレクトリを使用するため、多言語の技術ドキュメントを容易に維持できます。

READMEと技術ドキュメントの翻訳

READMEファイルや技術ドキュメントは、オープンソースプロジェクトや開発者ツールにおいて、ローカリゼーションの影響が最も大きいコンテンツの一つです。

• README.mdファイル: GitHub、npm、PyPIでユーザーが最初に目にするものです。READMEを翻訳することで、英語圏以外の市場での採用率が大幅に向上します。READMEを中国語、日本語、韓国語、スペイン語、またはポルトガル語に翻訳すれば、プロジェクトのリーチを劇的に拡大できます。
• GitHub Wiki: GitHub WikiはMarkdownを使用しており、大規模なオープンソースプロジェクトでローカリゼーションが進んでいます。翻訳されたWikiページは、異なる地域の貢献者やユーザーがプロジェクトのドキュメントを理解するのに役立ちます。
• CHANGELOG.mdおよびリリースノート: 変更履歴やリリースノートを翻訳することで、海外のユーザーはバージョン間の変更点やそれが自分に与える影響を理解できます。
• APIドキュメント: Markdownで記述されたAPIリファレンスドキュメント（Slate、Redoc、Swagger UIなどのツールを使用）を翻訳することで、異なる地域の開発者がより効果的にAPIを統合できるようになります。

Markdown翻訳のためのAI用語集生成

当社のAI用語集生成機能は、すべてのMarkdownドキュメントで一貫した用語を維持するのに役立ちます。翻訳オプションで用語集を生成を切り替えて有効にしてください。

• 一貫した用語 — AIがソースのMarkdownコンテンツと既存のターゲット翻訳を分析して主要な用語の用語集を構築し、製品名、技術概念、UIラベルがすべてのドキュメントページで一貫して翻訳されるようにします。
• ドメイン固有語彙 — ターゲット文字列フィールドに、すでに翻訳されたMarkdownコンテンツのサンプルを提供してください。AIは好みの用語を学習し、新しいドキュメントページに自動的に適用します。
• 使用方法 — 用語集生成が有効な場合に表示されるオプションのターゲット文字列フィールドに、翻訳済みのMarkdownコンテンツを貼り付けます。AIは繰り返される用語ペアを抽出し、翻訳ガイドとして使用します。ターゲットコンテンツが提供されない場合、AIはソースドキュメントのみから用語集を生成します。

Markdown翻訳にl10n.devを使用する理由

• AI対応ローカリゼーション: 当社のAIはMarkdown構造を理解し、コンテキスト、専門用語、および周辺のドキュメントを認識した上でテキストを翻訳します。
• 完全なフォーマット保持: 見出し、太字/斜体、リスト、表、ブロック引用、およびすべてのMarkdown構文が正確に保持されます。人間が読むテキストのみが翻訳されます。
• フロントマターのサポート: YAMLフロントマターはインテリジェントに処理されます。タイトルや説明などの翻訳可能なメタデータは翻訳され、スラッグ、日付、IDなどの技術的なフィールドは変更されません。
• コードブロックの保護: すべてのコードブロック（フェンス付きおよびインデント付き）、インラインコード、および技術的な識別子は、翻訳中も完全に変更されません。
• リンクと画像の保持: すべてのURL、画像パス、アンカー、および参照リンクはそのまま維持されます。リンクテキストと画像の代替テキストのみが翻訳されます。
• 費用対効果: 当社のサービスは、他の機械翻訳ソリューションよりも手頃な価格です。ユーザーは毎月30,000文字分を無料で利用できます。料金を見る
• 長文ドキュメントに最適化: 長いMarkdownファイル（ブログ投稿、完全なドキュメントページ、複数セクションのガイドなど）を効率的に処理し、翻訳全体で一貫性を維持します。

Markdown翻訳の一般的なユースケース

Markdown翻訳は、幅広いドキュメントやコンテンツのローカリゼーションシナリオで使用されています。

• README.mdのローカリゼーション: GitHub、GitLab、またはBitbucketのREADMEファイルを翻訳し、海外の開発者がプロジェクト、インストール手順、使用例を理解できるようにします。
• ドキュメントWebサイト: Docusaurus、VitePress、MkDocs、またはGitBookドキュメントサイトを翻訳し、世界中の開発者が技術ドキュメントにアクセスできるようにします。
• 静的サイトコンテンツ: Jekyll、Hugo、Gatsby、またはAstroのページコンテンツを翻訳し、言語ごとに適切なSEOを備えた多言語Webサイトを提供します。
• GitHub Wikiページ: オープンソースプロジェクトのWikiをローカライズし、異なる言語背景を持つ貢献者やユーザーがプロジェクトをナビゲートして貢献できるようにします。
• 技術ブログ投稿: Markdownで書かれた開発者向けブログ投稿、チュートリアル、ハウツーガイドを翻訳し、世界中のエンジニアや技術ユーザーに届けます。
• ナレッジベース記事: Notionエクスポート、Outline、またはカスタムナレッジベースなどのツールにMarkdownとして保存されているヘルプ記事、FAQ、サポートドキュメントを翻訳します。
• リリースノートと変更履歴: CHANGELOG.mdファイルとリリースノートを翻訳し、海外のチームやユーザーが製品の更新情報を自国語で把握できるようにします。

Markdownと他のローカリゼーション形式の比較

Markdownはローカリゼーションエコシステムにおいてユニークな位置を占めています。分離された翻訳文字列を格納するJSON、YAML、またはXLIFFとは異なり、Markdownファイルには、自然言語テキスト、コードサンプル、構造化された構文、メタデータといった混在コンテンツを含む完全な散文ドキュメントが含まれています。これにより、Markdown翻訳は文字列ベースのローカリゼーションとは根本的に異なります。

従来のローカリゼーションワークフローでは、翻訳可能な文字列をリソースファイルに抽出し、個別に翻訳します。一方、Markdownローカリゼーションでは、構造を保持しながらドキュメント全体を翻訳します。これには、ドキュメントのどの部分を翻訳すべきか（散文、見出し、リスト項目、代替テキスト）と、決して触れてはならない部分（コードブロック、URL、フロントマターキー）を理解するAIが必要です。

当社のAI翻訳はMarkdownドキュメントをネイティブに処理するため、文字列を前処理したり抽出したりする必要はありません。Markdownファイルを貼り付け、ターゲット言語を選択するだけで、完全に翻訳され、構造が維持された<code>.md</code>ファイルが生成され、リポジトリにコミットできる状態になります。

よくある質問

翻訳中に保持されるMarkdown要素は何ですか？

すべてのMarkdown構文が保持されます：見出し（#、##）、太字（**）、斜体（*）、リスト、表、ブロック引用（>）、リンク（[text](url)）、画像（![alt](src)）、およびフェンス付きコードブロック（```）。ブロック内やバッククォート内のコードコンテンツは決して翻訳されません。

YAMLフロントマターは翻訳されますか？

はい、選択的に翻訳されます。当社のAIは、title、description、sidebar_labelなどの人間が読めるフロントマターフィールドを翻訳します。slug、date、lang、draft、weight、idなどの技術的なフィールドは、静的サイトジェネレーターとの互換性を確保するために変更されません。

Markdownファイルを翻訳するにはどうすればよいですか？

.mdファイルの内容を上記のエディタに貼り付け、ターゲット言語コード（例：fr、de、ja、zh）を入力して、翻訳をクリックします。AIは、すべてのフォーマットを保持した完全に翻訳されたMarkdownドキュメントを返します。結果をコピーするか、.mdファイルとして保存できます。

大きなMarkdownファイルを翻訳できますか？

このページは、数百キロバイトまでの個別のMarkdownファイルに最適です。一括Markdown翻訳や非常に長いドキュメントの場合は、最大5MBのファイルアップロードをサポートし、大規模なコンテンツローカリゼーションに対してより信頼性の高い配信を提供するi18nファイル翻訳ページの使用をお勧めします。