Cara Menerjemahkan File Markdown

Menerjemahkan file Markdown cepat dan mudah dengan alat bertenaga AI kami. Ikuti langkah-langkah ini untuk mendapatkan terjemahan yang akurat dan mempertahankan format untuk dokumentasi, file README, dan konten situs statis Anda.

1. Tempel konten Markdown Anda: Salin dan tempel konten file .md Anda ke area teks di atas. Mendukung Markdown standar, GitHub Flavored Markdown (GFM), dan Markdown dengan front matter YAML.
2. Atur bahasa target: Masukkan kode bahasa ISO yang ingin Anda terjemahkan (misalnya, fr untuk bahasa Prancis, de untuk bahasa Jerman, ja untuk bahasa Jepang).
3. Klik Terjemahkan: AI kami akan menerjemahkan konten teks sambil mempertahankan semua pemformatan Markdown — judul, tebal/miring, daftar, blok kode, tautan, gambar, dan front matter.
4. Salin atau simpan hasilnya: Setelah penerjemahan selesai, salin Markdown yang diterjemahkan ke clipboard Anda atau simpan langsung sebagai file .md.

Apa Itu Markdown dan Mengapa Menerjemahkannya?

Markdown adalah bahasa markup ringan yang mengubah teks biasa menjadi HTML berformat. Dibuat oleh John Gruber pada tahun 2004, Markdown telah menjadi format standar untuk dokumentasi, file README, wiki, dan sistem manajemen konten di seluruh dunia. Sintaksnya yang sederhana dan mudah dibaca menjadikannya ideal bagi penulis teknis, pengembang, dan pembuat konten.

Seiring produk perangkat lunak dan dokumentasi menjangkau audiens global, menerjemahkan konten Markdown menjadi penting. Melokalkan file README, panduan pengguna, dokumentasi API, dan postingan blog Anda memastikan pengguna dalam berbagai bahasa dapat sepenuhnya memahami dan menggunakan produk Anda. Dokumentasi yang dilokalkan dengan buruk atau tidak diterjemahkan adalah salah satu hambatan terbesar bagi adopsi internasional.

Menerjemahkan Markdown secara manual rentan terhadap kesalahan — sangat mudah untuk secara tidak sengaja merusak sintaks pemformatan, merusak blok kode, atau merusak struktur tautan. Terjemahan Markdown bertenaga AI kami mempertahankan semua elemen sintaks sambil secara akurat menerjemahkan hanya konten teks yang dapat dibaca manusia.

Sintaks dan Struktur Markdown

Dokumen Markdown yang khas berisi campuran elemen teks berformat. Mesin terjemahan kami memahami dan mempertahankan semuanya:

# 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).

• Judul (#, ##, ###): Judul bagian diterjemahkan sementara penanda tingkat judul dipertahankan persis apa adanya.
• Tebal dan miring (**text**, *text*): Penanda penekanan inline tetap utuh di sekitar teks yang diterjemahkan.
• Daftar terurut dan tidak terurut (-, *, 1.): Struktur daftar dan penumpukan dipertahankan; hanya teks item daftar yang diterjemahkan.
• Blok kode (```) dan kode inline (`): Semua konten kode dipertahankan tanpa tersentuh. AI tidak pernah menerjemahkan kode, perintah, atau pengidentifikasi teknis.
• Tautan ([text](url)) dan gambar (![alt](src)): URL dan jalur gambar tetap tidak berubah. Hanya teks tautan dan teks alt gambar yang diterjemahkan.
• Kutipan blok (>): Penanda kutipan blok dipertahankan; konten teks yang dikutip diterjemahkan.

Dukungan YAML Front Matter

Banyak file Markdown yang digunakan dalam generator situs statis (Jekyll, Hugo, Docusaurus, Gatsby) menyertakan YAML front matter — metadata di bagian atas file yang dibatasi oleh ---. AI kami menangani front matter dengan cerdas:

---
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.

Nilai yang dapat diterjemahkan seperti <code>title</code>, <code>description</code>, dan <code>sidebar_label</code> diterjemahkan, sementara kunci teknis seperti <code>date</code>, <code>slug</code>, <code>lang</code>, <code>draft</code>, dan <code>weight</code> dibiarkan tidak berubah. Ini memastikan file Markdown Anda yang diterjemahkan segera kompatibel dengan generator situs statis atau CMS Anda.

Markdown dalam Lokalisasi Perangkat Lunak

Markdown telah menjadi warga kelas satu dalam lokalisasi perangkat lunak. Seiring praktik dokumentasi-sebagai-kode menyebar, tim menyimpan dokumentasi di repositori Git bersama kode sumber — dan Markdown adalah format pilihannya. Melokalkan dokumentasi ini memerlukan ketelitian yang sama seperti melokalkan string UI.

Platform lokalisasi modern semakin mendukung Markdown bersama format tradisional seperti XLIFF, PO, dan JSON. Baik Anda melokalkan repositori GitHub, situs web dokumentasi, atau basis pengetahuan, terjemahan Markdown sekarang menjadi bagian inti dari alur kerja internasionalisasi.

Lokalisasi Markdown untuk Generator Situs Statis

Generator situs statis mengandalkan file Markdown dengan front matter untuk konten multibahasa. Setiap bahasa biasanya memiliki direktori file Markdown terjemahannya sendiri:

• Jekyll: Menggunakan _posts dan direktori konten dengan folder per bahasa atau front matter khusus bahasa. jekyll-multiple-languages-plugin dan jekyll-polyglot milik Jekyll mengelola halaman Markdown multibahasa.
• Hugo: Mendukung terjemahan konten melalui direktori khusus bahasa (content/en/, content/fr/) atau dengan menambahkan kode bahasa ke nama file (about.fr.md). Mode multibahasa bawaan Hugo digunakan secara luas untuk situs dokumentasi dan pemasaran.
• Docusaurus: Docusaurus milik Facebook menggunakan folder i18n/ khusus untuk halaman Markdown yang diterjemahkan, dengan struktur file yang sama dicerminkan untuk setiap bahasa. Menerjemahkan file Markdown Docusaurus adalah salah satu kasus penggunaan paling umum untuk lokalisasi Markdown.
• Gatsby: Situs Gatsby menggunakan plugin seperti gatsby-plugin-i18n dan menyimpan konten yang diterjemahkan sebagai file Markdown terpisah per lokal, sering kali dengan front matter yang menentukan bahasa dan slug.
• VitePress: Kerangka kerja dokumentasi VitePress dari Vue menggunakan subdirektori khusus bahasa untuk file Markdown yang diterjemahkan, sehingga memudahkan pemeliharaan dokumentasi teknis multibahasa.

Terjemahan README dan Dokumentasi Teknis

File README dan dokumentasi teknis adalah konten yang paling berdampak untuk dilokalisasi bagi proyek sumber terbuka dan alat pengembang:

• File README.md: Hal pertama yang dilihat pengguna di GitHub, npm, atau PyPI. README yang diterjemahkan secara signifikan meningkatkan adopsi di pasar non-Inggris. Menerjemahkan README Anda ke bahasa Mandarin, Jepang, Korea, Spanyol, atau Portugis dapat memperluas jangkauan proyek Anda secara dramatis.
• GitHub Wiki: GitHub Wiki menggunakan Markdown dan semakin banyak dilokalisasi untuk proyek sumber terbuka yang besar. Halaman wiki yang diterjemahkan membantu kontributor dan pengguna dari berbagai wilayah memahami dokumentasi proyek.
• CHANGELOG.md dan catatan rilis: Menerjemahkan changelog dan catatan rilis membantu pengguna internasional memahami apa yang berubah antar versi dan bagaimana pengaruhnya terhadap mereka.
• Dokumentasi API: Dokumentasi referensi API yang ditulis dalam Markdown (menggunakan alat seperti Slate, Redoc, atau Swagger UI) mendapatkan manfaat dari terjemahan untuk membantu pengembang di berbagai wilayah mengintegrasikan API Anda dengan lebih efektif.

Pembuatan Glosarium AI untuk Terjemahan Markdown

Fitur Pembuatan Glosarium AI kami membantu Anda menjaga konsistensi istilah di seluruh dokumentasi Markdown Anda. Aktifkan dengan mengaktifkan Hasilkan Glosarium di opsi terjemahan:

• Konsistensi istilah — AI menganalisis konten Markdown sumber dan terjemahan target yang ada untuk membangun glosarium istilah utama, memastikan nama produk, konsep teknis, dan label UI diterjemahkan secara konsisten di semua halaman dokumentasi Anda.
• Istilah khusus domain — berikan contoh konten Markdown yang sudah diterjemahkan di bidang string target. AI mempelajari terminologi pilihan Anda dan menerapkannya ke halaman dokumentasi baru secara otomatis.
• Cara menggunakannya — tempel konten Markdown Anda yang telah diterjemahkan ke dalam bidang string target opsional yang muncul saat pembuatan glosarium diaktifkan. AI mengekstrak pasangan istilah yang berulang dan menggunakannya sebagai panduan terjemahan. Jika tidak ada konten target yang disediakan, AI akan membuat glosarium dari dokumentasi sumber saja.

Mengapa Menggunakan l10n.dev untuk Terjemahan Markdown?

• Terjemahan Kontekstual Berbasis AI: AI kami memahami struktur Markdown dan menerjemahkan teks dengan kesadaran akan konteks, terminologi klinis, dan dokumentasi di sekitarnya.
• Pelestarian Format Lengkap: Judul, tebal/miring, daftar, tabel, blok kutipan, dan semua sintaks Markdown dipertahankan persis. Hanya teks yang dapat dibaca manusia yang diterjemahkan.
• Dukungan Front Matter: YAML front matter ditangani dengan cerdas — metadata yang dapat diterjemahkan seperti judul dan deskripsi akan diterjemahkan; bidang teknis seperti slug, tanggal, dan ID dibiarkan tidak berubah.
• Perlindungan Blok Kode: Semua blok kode (yang dipagari dan menjorok), kode inline, dan pengidentifikasi teknis dibiarkan sepenuhnya tidak tersentuh selama terjemahan.
• Pelestarian Tautan dan Gambar: Semua URL, jalur gambar, jangkar, dan tautan referensi tetap utuh. Hanya teks tautan dan teks alt gambar yang diterjemahkan.
• Hemat biaya: Layanan kami lebih terjangkau daripada solusi terjemahan mesin lainnya. Pengguna menerima 10,000 karakter gratis setiap bulan. Lihat Harga
• Dioptimalkan untuk Dokumen Panjang: Memproses file Markdown yang panjang secara efisien — posting blog, halaman dokumentasi lengkap, dan panduan multi-bagian — menjaga konsistensi terjemahan di seluruh bagian.

Kasus Penggunaan Umum untuk Terjemahan Markdown

Terjemahan Markdown digunakan di berbagai skenario dokumentasi dan lokalisasi konten:

• Lokalisasi README.md: Terjemahkan file README GitHub, GitLab, atau Bitbucket Anda untuk membantu pengembang internasional memahami proyek, langkah instalasi, dan contoh penggunaan Anda.
• Situs Web Dokumentasi: Terjemahkan situs dokumentasi Docusaurus, VitePress, MkDocs, atau GitBook agar dokumentasi teknis dapat diakses oleh pengembang di seluruh dunia.
• Konten Situs Statis: Terjemahkan konten halaman Jekyll, Hugo, Gatsby, atau Astro untuk menghadirkan situs web multibahasa dengan SEO yang tepat untuk setiap bahasa.
• Halaman GitHub Wiki: Lokalisasi wiki proyek sumber terbuka untuk membantu kontributor dan pengguna dari berbagai latar belakang bahasa menavigasi dan berkontribusi pada proyek Anda.
• Posting Blog Teknis: Terjemahkan posting blog pengembang, tutorial, dan panduan cara pakai yang ditulis dalam Markdown untuk menjangkau insinyur dan pengguna teknis secara global.
• Artikel Basis Pengetahuan: Terjemahkan artikel bantuan, FAQ, dan dokumentasi dukungan yang disimpan sebagai Markdown dalam alat seperti ekspor Notion, Outline, atau basis pengetahuan kustom.
• Catatan Rilis dan Changelog: Terjemahkan file CHANGELOG.md dan catatan rilis agar tim dan pengguna internasional tetap mendapatkan informasi tentang pembaruan produk dalam bahasa mereka.

Markdown vs. Format Lokalisasi Lainnya

Markdown menempati posisi unik dalam ekosistem lokalisasi. Tidak seperti JSON, YAML, atau XLIFF — yang menyimpan string terjemahan terisolasi — file Markdown berisi dokumen prosa lengkap dengan konten campuran: teks bahasa alami, sampel kode, sintaks terstruktur, dan metadata. Hal ini membuat terjemahan Markdown sangat berbeda dari lokalisasi berbasis string.

Alur kerja lokalisasi tradisional mengekstrak string yang dapat diterjemahkan ke dalam file sumber daya dan menerjemahkannya satu per satu. Sebaliknya, lokalisasi Markdown menerjemahkan seluruh dokumen sambil mempertahankan strukturnya. Hal ini memerlukan AI yang memahami bagian dokumen mana yang harus diterjemahkan (prosa, judul, item daftar, teks alt) dan mana yang tidak boleh disentuh (blok kode, URL, kunci front matter).

Terjemahan AI kami menangani dokumen Markdown secara native — tidak perlu memproses atau mengekstrak string terlebih dahulu. Tempel file Markdown Anda, pilih bahasa target, dan terima file <code>.md</code> yang telah diterjemahkan sepenuhnya dan utuh secara struktural, siap untuk dikomit ke repositori Anda.

Pertanyaan yang Sering Diajukan

Elemen Markdown apa yang dipertahankan selama terjemahan?

Semua sintaks Markdown dipertahankan: judul (#, ##), tebal (**), miring (*), daftar, tabel, blok kutipan (>), tautan ([teks](url)), gambar (![alt](src)), dan blok kode yang dipagari (```). Konten kode di dalam blok dan backtick tidak pernah diterjemahkan.

Apakah YAML front matter diterjemahkan?

Ya, secara selektif. AI kami menerjemahkan bidang front matter yang dapat dibaca manusia seperti title, description, dan sidebar_label. Bidang teknis seperti slug, date, lang, draft, weight, dan id dibiarkan tidak berubah untuk memastikan kompatibilitas dengan generator situs statis Anda.

Bagaimana cara menerjemahkan file Markdown?

Tempel konten file .md Anda ke editor di atas, masukkan kode bahasa target (misalnya, fr, de, ja, zh), dan klik Terjemahkan. AI akan mengembalikan dokumen Markdown yang telah diterjemahkan sepenuhnya dengan mempertahankan semua pemformatan. Anda dapat menyalin hasilnya atau menyimpannya sebagai file .md.

Bisakah saya menerjemahkan file Markdown yang besar?

Halaman ini berfungsi paling baik untuk file Markdown individual hingga beberapa ratus kilobyte. Untuk terjemahan Markdown massal atau dokumen yang sangat panjang, kami sarankan menggunakan halaman Terjemahan File i18n, yang mendukung unggahan file hingga 5 MB dan memberikan pengiriman yang lebih andal untuk lokalisasi konten skala besar.