Markdown翻訳
ターゲット言語: zh-Hans-CN (Chinese, Simplified Chinese, China)
ターゲット言語のコード。例: ja, ja-JP, fil, zh-Hans-CN。検索するには入力してください。
メタデータを翻訳する:
短縮形を使用:
短縮を使用:
用語:
Markdownソースコンテンツ:
AIがコンテンツを処理するため、翻訳には時間がかかります(最大5分)。このMarkdown翻訳ページはリアルタイムで翻訳を行い、サーバー上にコンテンツを保存することはありません。大きなMarkdownファイルの場合は、より信頼性の高い配信のためにI18Nファイル翻訳ページの使用をお勧めします。翻訳が完了するまでこのページから離れないでください。

Markdownファイルの翻訳方法

当社のAI搭載ツールを使えば、Markdownファイルの翻訳は迅速かつ簡単です。以下の手順に従って、ドキュメント、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年にジョン・グルーバーによって作成されて以来、世界中のドキュメント、READMEファイル、Wiki、コンテンツ管理システムの標準フォーマットとなっています。シンプルで読みやすい構文は、技術ライター、開発者、コンテンツ作成者に最適です。

ソフトウェア製品やドキュメントが世界中のユーザーに届くようになるにつれ、Markdownコンテンツの翻訳は不可欠なものとなっています。READMEファイル、ユーザーガイド、APIドキュメント、ブログ記事をローカライズすることで、言語の壁を超えてユーザーが製品を完全に理解し、活用できるようになります。不十分なローカライズや翻訳されていないドキュメントは、国際的な普及を妨げる最大の要因の一つです。

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と画像パスは変更されません。リンクテキストと画像のaltテキストのみが翻訳されます。
  • 引用 (>): 引用マーカーは保持され、引用されたテキスト内容が翻訳されます。

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リポジトリ、ドキュメントサイト、ナレッジベースのいずれをローカライズする場合でも、Markdown翻訳は国際化ワークフローの中核となっています。

静的サイトジェネレーターのためのMarkdownローカライズ

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

  • Jekyll: _postsやコンテンツディレクトリを使用し、言語ごとのフォルダーや言語固有のフロントマターを管理します。Jekyllのjekyll-multiple-languages-pluginjekyll-polyglotが多言語Markdownページを管理します。
  • Hugo: 言語固有のディレクトリ(content/en/content/fr/)や、ファイル名への言語コードの追加(about.fr.md)によるコンテンツ翻訳をサポートしています。Hugoの組み込み多言語モードは、ドキュメントやマーケティングサイトで広く使用されています。
  • Docusaurus: FacebookのDocusaurusは、翻訳されたMarkdownページ専用のi18n/フォルダーを使用し、各言語で同じファイル構造をミラーリングします。DocusaurusのMarkdownファイル翻訳は、Markdownローカライズの最も一般的なユースケースの一つです。
  • 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翻訳にl10n.devを使うのか?

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

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

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

  • README.mdのローカライズ: GitHub、GitLab、BitbucketのREADMEファイルを翻訳し、海外の開発者がプロジェクト、インストール手順、使用例を理解できるようにします。
  • ドキュメントサイト: 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ローカライズはドキュメント全体を翻訳しながら構造を保持します。これには、ドキュメントのどの部分を翻訳すべきか(散文、見出し、リスト項目、altテキスト)、どの部分を決して触れてはならないか(コードブロック、URL、フロントマターのキー)を理解するAIが必要です。

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

よくある質問

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

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

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

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

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

.mdファイルの内容を上記のエディターに貼り付け、ターゲット言語コード(例: frdejazh)を入力して「翻訳」をクリックしてください。AIがすべての書式を保持した完全に翻訳されたMarkdownドキュメントを返します。結果をコピーするか、.mdファイルとして保存できます。

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

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