Traduire le texte rédigé d’un fichier Markdown

Traduire du Markdown en préservant frontmatter et blocs de code

Traduction de fichiers Markdown : frontmatter intact, blocs de code intacts, marqueurs de structure conservés. Liens et images protégés pendant la traduction.

Déposez votre fichier, ou choisissez-le

Markdown avec ou sans frontmatter YAML ou TOML.

Le fichier n’est envoyé qu’au moment où vous lancez l’analyse. Il est supprimé après traitement.

Ce que fait cet outil

Un diff lisible, ligne pour ligne

Comme le nombre de lignes et les marqueurs sont préservés, la comparaison avec l’original met en évidence le texte traduit et rien d’autre.

Liens et images protégés

Le code en ligne, les images, les URL brutes, le HTML inline et les variables de gabarit sont masqués avant traduction, puis remis en place.

Le frontmatter reste votre source de vérité

Traduire un identifiant, une date ou une liste d’étiquettes dans le frontmatter casserait la génération du site. Il est donc exclu du périmètre.

Exemples

Structure et code préservés

Avant

## Installation rapide

Installez le paquet, puis lancez la commande :

```bash
npm install mon-paquet
```

Après

## Quick install

Install the package, then run the command:

```bash
npm install mon-paquet
```

Exemple rédigé par la rédaction. Le niveau de titre, la ligne vide et le bloc de code sont inchangés ; la commande n’a pas été traduite.

Quand l’utiliser

Traduire la documentation d’un projet

Les exemples de commandes et de code restent exécutables, ce qui est la première exigence d’une documentation technique.

Publier un article de blog dans une seconde langue

Le frontmatter conserve la date, les étiquettes et l’identifiant ; vous ajustez ensuite le titre et l’adresse.

Traduire un fichier README

Badges, liens et extraits de code sont préservés ; seul le texte explicatif change.

Préparer une relecture dans un gestionnaire de versions

Le diff ligne par ligne permet une revue par pull request, segment par segment.

Mode d’emploi

  1. Déposez votre fichier Markdown : l’analyse indique le nombre de segments traduisibles et la présence d’un frontmatter.
  2. Choisissez la langue cible.
  3. Lancez la traduction, puis consultez le rapport, en particulier l’égalité du nombre de lignes.
  4. Relisez le fichier, et mettez à jour titre, description et liens d’ancres dans le frontmatter si nécessaire.

Limites et confidentialité

Ce que cet outil ne fait pas

  • Les tableaux Markdown sont traduits cellule par cellule ; la largeur des colonnes n’est pas réalignée.
  • Les notes de bas de page et les définitions de référence de lien sont traitées comme du texte ordinaire.
  • Les extensions propres à un générateur de site (encarts, directives, composants) peuvent être partiellement protégées seulement.
  • Les ancres de titres changent avec le texte traduit : les liens internes pointant vers ces ancres doivent être mis à jour.
  • Le frontmatter n’est pas traduit, y compris lorsqu’il contient un titre ou une description destinés à l’affichage.

Vos données

  • Le fichier est traité en mémoire puis supprimé : il n’est pas conservé après le téléchargement.
  • Le contenu du fichier n’est jamais journalisé. Les journaux techniques ne retiennent que la durée, le moteur, les codes de langue, la taille et le statut.
  • Le nom de votre fichier n’est pas réutilisé côté serveur : il est assaini avant toute écriture.
  • Aucun texte soumis n’est réutilisé pour entraîner un modèle.

Politique de confidentialité complète

Questions fréquentes

Le titre de mon frontmatter sera-t-il traduit ?

Non, délibérément. Le frontmatter est restitué octet pour octet, car il contient aussi des identifiants, des dates et des chemins qu’une traduction casserait. Modifiez-y le titre et la description à la main après coup.

Mes blocs de code peuvent-ils être altérés ?

Les blocs délimités par trois accents graves ou trois tildes, ainsi que les blocs indentés de quatre espaces, sont ignorés par l’extraction : leur contenu ne quitte jamais le fichier.

Quelle variante de Markdown est prise en charge ?

Le découpage suit les constructions courantes décrites par CommonMark, étendues aux tableaux et aux cases à cocher d’usage répandu. Les directives propres à un générateur particulier ne sont pas garanties.

Sources

  1. CommonMark — spécification Markdown — Version 0.31.2 publiée le 28 janvier 2024
  2. Documentation LibreTranslate — API libre reposant sur Argos Translate, publiée sous AGPL-3.0

Page vérifiée le . Intention dominante de cette page : traduire le texte rédigé d’un fichier markdown. Comment nous travaillons.