Come tradurre file Markdown

Tradurre file Markdown è facile e veloce con il nostro strumento basato sull'IA. Segui questi passaggi per ottenere traduzioni accurate che preservano la formattazione per la tua documentazione, file README e contenuti di siti statici.

1. Incolla il tuo contenuto Markdown: Copia e incolla il contenuto del tuo file .md nell'area di testo qui sopra. Supporta Markdown standard, GitHub Flavored Markdown (GFM) e Markdown con front matter YAML.
2. Imposta la lingua di destinazione: Inserisci il codice ISO della lingua in cui desideri tradurre (es. fr per il francese, de per il tedesco, ja per il giapponese).
3. Clicca su Traduci: La nostra IA tradurrà il contenuto testuale preservando tutta la formattazione Markdown: intestazioni, grassetto/corsivo, elenchi, blocchi di codice, link, immagini e front matter.
4. Copia o salva il risultato: Una volta completata la traduzione, copia il Markdown tradotto negli appunti o salvalo direttamente come file .md.

Cos'è il Markdown e perché tradurlo?

Il Markdown è un linguaggio di marcatura leggero che converte testo semplice in HTML formattato. Creato da John Gruber nel 2004, è diventato il formato standard per documentazione, file README, wiki e sistemi di gestione dei contenuti in tutto il mondo. La sua sintassi semplice e leggibile lo rende ideale per redattori tecnici, sviluppatori e creatori di contenuti.

Man mano che i prodotti software e la documentazione raggiungono un pubblico globale, la traduzione dei contenuti Markdown diventa essenziale. Localizzare i tuoi file README, guide utente, documentazione API e post di blog assicura che gli utenti di diverse lingue possano comprendere e utilizzare appieno il tuo prodotto. Una documentazione localizzata male o non tradotta è uno dei maggiori ostacoli all'adozione internazionale.

Tradurre il Markdown manualmente è soggetto a errori: è facile rompere accidentalmente la sintassi di formattazione, corrompere i blocchi di codice o danneggiare le strutture dei link. La nostra traduzione Markdown basata sull'IA preserva tutti gli elementi della sintassi traducendo accuratamente solo il contenuto testuale leggibile dall'uomo.

Sintassi e struttura Markdown

Un tipico documento Markdown contiene un mix di elementi di testo formattati. Il nostro motore di traduzione li comprende e li preserva tutti:

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

• Intestazioni (#, ##, ###): I titoli delle sezioni vengono tradotti mentre i marcatori del livello di intestazione sono preservati esattamente come sono.
• Grassetto e corsivo (**testo**, *testo*): I marcatori di enfasi in linea sono mantenuti intatti attorno al testo tradotto.
• Elenchi ordinati e non ordinati (-, *, 1.): La struttura e l'annidamento degli elenchi sono preservati; viene tradotto solo il testo dell'elemento dell'elenco.
• Blocchi di codice (```) e codice in linea (`): Tutto il contenuto del codice viene preservato intatto. L'IA non traduce mai codice, comandi o identificatori tecnici.
• Link ([testo](url)) e immagini (![alt](src)): Gli URL e i percorsi delle immagini rimangono invariati. Vengono tradotti solo il testo del link e il testo alternativo dell'immagine.
• Citazioni (>): I marcatori di citazione sono preservati; il contenuto del testo citato viene tradotto.

Supporto YAML Front Matter

Molti file Markdown utilizzati nei generatori di siti statici (Jekyll, Hugo, Docusaurus, Gatsby) includono YAML front matter: metadati nella parte superiore del file delimitati da ---. La nostra IA gestisce in modo intelligente il front matter:

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

I valori traducibili come <code>title</code>, <code>description</code> e <code>sidebar_label</code> vengono tradotti, mentre le chiavi tecniche come <code>date</code>, <code>slug</code>, <code>lang</code>, <code>draft</code> e <code>weight</code> rimangono invariate. Ciò garantisce che i tuoi file Markdown tradotti siano immediatamente compatibili con il tuo generatore di siti statici o CMS.

Markdown nella localizzazione software

Il Markdown è diventato un cittadino di prima classe nella localizzazione software. Con la diffusione delle pratiche di documentazione come codice, i team archiviano la documentazione nei repository Git insieme al codice sorgente, e il Markdown è il formato preferito. Localizzare questa documentazione richiede lo stesso rigore della localizzazione delle stringhe dell'interfaccia utente.

Le moderne piattaforme di localizzazione supportano sempre più il Markdown insieme ai formati tradizionali come XLIFF, PO e JSON. Che tu stia localizzando un repository GitHub, un sito di documentazione o una knowledge base, la traduzione Markdown è ora una parte fondamentale del flusso di lavoro di internazionalizzazione.

Localizzazione Markdown per generatori di siti statici

I generatori di siti statici si basano su file Markdown con front matter per contenuti multilingue. Ogni lingua ha solitamente la propria directory di file Markdown tradotti:

• Jekyll: Utilizza _posts e directory di contenuto con cartelle per lingua o front matter specifico per lingua. Il jekyll-multiple-languages-plugin e jekyll-polyglot di Jekyll gestiscono pagine Markdown multilingue.
• Hugo: Supporta la traduzione dei contenuti tramite directory specifiche per lingua (content/en/, content/fr/) o aggiungendo codici lingua ai nomi dei file (about.fr.md). La modalità multilingue integrata di Hugo è ampiamente utilizzata per siti di documentazione e marketing.
• Docusaurus: Docusaurus di Facebook utilizza una cartella i18n/ dedicata per le pagine Markdown tradotte, con la stessa struttura di file rispecchiata per ogni lingua. Tradurre file Markdown di Docusaurus è uno dei casi d'uso più comuni per la localizzazione Markdown.
• Gatsby: I siti Gatsby utilizzano plugin come gatsby-plugin-i18n e archiviano i contenuti tradotti come file Markdown separati per locale, spesso con front matter che specifica la lingua e lo slug.
• VitePress: Il framework di documentazione VitePress di Vue utilizza sottodirectory specifiche per lingua per i file Markdown tradotti, rendendo facile mantenere la documentazione tecnica multilingue.

Traduzione di README e documentazione tecnica

I file README e la documentazione tecnica sono tra i contenuti di maggior impatto da localizzare per progetti open source e strumenti per sviluppatori:

• File README.md: La prima cosa che gli utenti vedono su GitHub, npm o PyPI. Un README tradotto aumenta significativamente l'adozione nei mercati non anglofoni. Tradurre il tuo README in cinese, giapponese, coreano, spagnolo o portoghese può espandere notevolmente la portata del tuo progetto.
• GitHub Wiki: Le Wiki di GitHub utilizzano il Markdown e sono sempre più localizzate per grandi progetti open source. Le pagine wiki tradotte aiutano i collaboratori e gli utenti di diverse regioni a comprendere la documentazione del progetto.
• CHANGELOG.md e note di rilascio: Tradurre i changelog e le note di rilascio aiuta gli utenti internazionali a capire cosa è cambiato tra le versioni e come li influenza.
• Documentazione API: La documentazione di riferimento delle API scritta in Markdown (utilizzando strumenti come Slate, Redoc o Swagger UI) beneficia della traduzione per aiutare gli sviluppatori in diverse regioni a integrare la tua API in modo più efficace.

Perché utilizzare l10n.dev per la traduzione Markdown?

• Traduzione contestuale basata sull'IA: La nostra IA comprende la struttura Markdown e traduce il testo con consapevolezza del contesto, della terminologia tecnica e della documentazione circostante.
• Preservazione completa del formato: Intestazioni, grassetto/corsivo, elenchi, tabelle, citazioni e tutta la sintassi Markdown sono preservati esattamente. Viene tradotto solo il testo leggibile dall'uomo.
• Supporto Front Matter: Il front matter YAML viene gestito in modo intelligente: i metadati traducibili come titoli e descrizioni vengono tradotti; i campi tecnici come slug, date e ID rimangono invariati.
• Protezione dei blocchi di codice: Tutti i blocchi di codice (recintati e rientrati), il codice in linea e gli identificatori tecnici rimangono completamente intatti durante la traduzione.
• Preservazione di link e immagini: Tutti gli URL, i percorsi delle immagini, le ancore e i link di riferimento rimangono intatti. Vengono tradotti solo il testo del link e il testo alternativo dell'immagine.
• Conveniente: Il nostro servizio è più conveniente rispetto ad altre soluzioni di traduzione automatica. Gli utenti ricevono 30,000 caratteri gratuiti al mese. Visualizza Prezzi
• Ottimizzato per documenti lunghi: Elabora in modo efficiente file Markdown lunghi (post di blog, pagine di documentazione complete e guide multi-sezione), mantenendo la coerenza della traduzione in tutto il documento.

Casi d'uso comuni per la traduzione Markdown

La traduzione Markdown è utilizzata in una vasta gamma di scenari di localizzazione di documentazione e contenuti:

• Localizzazione README.md: Traduci i tuoi file README di GitHub, GitLab o Bitbucket per aiutare gli sviluppatori internazionali a comprendere il tuo progetto, i passaggi di installazione e gli esempi di utilizzo.
• Siti di documentazione: Traduci siti di documentazione Docusaurus, VitePress, MkDocs o GitBook per rendere la documentazione tecnica accessibile agli sviluppatori di tutto il mondo.
• Contenuti di siti statici: Traduci i contenuti delle pagine Jekyll, Hugo, Gatsby o Astro per fornire siti web multilingue con una corretta SEO per ogni lingua.
• Pagine GitHub Wiki: Localizza le wiki dei progetti open source per aiutare i collaboratori e gli utenti provenienti da contesti linguistici diversi a navigare e contribuire al tuo progetto.
• Post di blog tecnici: Traduci post di blog per sviluppatori, tutorial e guide pratiche scritte in Markdown per raggiungere ingegneri e utenti tecnici a livello globale.
• Articoli della Knowledge Base: Traduci articoli di aiuto, FAQ e documentazione di supporto archiviata come Markdown in strumenti come esportazioni Notion, Outline o knowledge base personalizzate.
• Note di rilascio e Changelog: Traduci i file CHANGELOG.md e le note di rilascio in modo che i team e gli utenti internazionali rimangano informati sugli aggiornamenti del prodotto nella loro lingua.

Markdown vs. altri formati di localizzazione

Il Markdown occupa una posizione unica nell'ecosistema della localizzazione. A differenza di JSON, YAML o XLIFF (che archiviano stringhe di traduzione isolate), i file Markdown contengono documenti in prosa completi con contenuti misti: testo in linguaggio naturale, esempi di codice, sintassi strutturata e metadati. Questo rende la traduzione Markdown fondamentalmente diversa dalla localizzazione basata su stringhe.

I flussi di lavoro di localizzazione tradizionali estraggono le stringhe traducibili in file di risorse e le traducono individualmente. La localizzazione Markdown invece traduce interi documenti preservandone la struttura. Ciò richiede un'IA che comprenda quali parti del documento debbano essere tradotte (prosa, intestazioni, elementi dell'elenco, testo alternativo) e quali non debbano mai essere toccate (blocchi di codice, URL, chiavi front matter).

La nostra traduzione IA gestisce i documenti Markdown in modo nativo: non è necessario pre-elaborare o estrarre stringhe. Incolla il tuo file Markdown, seleziona una lingua di destinazione e ricevi un file <code>.md</code> completamente tradotto e strutturalmente intatto, pronto per essere inviato al tuo repository.

Domande frequenti

Quali elementi Markdown vengono preservati durante la traduzione?

Tutta la sintassi Markdown viene preservata: intestazioni (#, ##), grassetto (**), corsivo (*), elenchi, tabelle, citazioni (>), link ([testo](url)), immagini (![alt](src)) e blocchi di codice recintati (```). Il contenuto del codice all'interno dei blocchi e dei backtick non viene mai tradotto.

Il front matter YAML viene tradotto?

Sì, in modo selettivo. La nostra IA traduce campi del front matter leggibili dall'uomo come title, description e sidebar_label. I campi tecnici come slug, date, lang, draft, weight e id rimangono invariati per garantire la compatibilità con il tuo generatore di siti statici.

Come traduco un file Markdown?

Incolla il contenuto del tuo file .md nell'editor qui sopra, inserisci il codice della lingua di destinazione (es. fr, de, ja, zh) e clicca su Traduci. L'IA restituirà un documento Markdown completamente tradotto preservando tutta la formattazione. Puoi copiare il risultato o salvarlo come file .md.

Posso tradurre file Markdown di grandi dimensioni?

Questa pagina funziona meglio per singoli file Markdown fino a poche centinaia di kilobyte. Per la traduzione in blocco di Markdown o documenti molto lunghi, consigliamo di utilizzare la pagina Traduzione file I18N, che supporta caricamenti di file fino a 5 MB e fornisce una consegna più affidabile per la localizzazione di contenuti su larga scala.