Echappement Markdown
Dans Use *stars* and _underscores_, chaque astérisque et chaque tiret bas reçoit une barre oblique inverse, comme dans \*stars\*, et les mots s'affichent tels quels au lieu de passer en gras ou en italique ; accents graves et crochets sont traités de même. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Texte
- Use *stars* and _underscores_ with `code`
- Mode de calcul
- Encode
- Résultat
- Use \*stars\* and \_underscores\_ with \`code\`
- Encodage
- markdown
- Longueur de l'entrée
- 41
- Longueur de la sortie
- 47
Cet échappeur Markdown convertit le texte brut en une forme préfixée de barres obliques inverses afin que les caractères spéciaux s'affichent comme des glyphes ordinaires plutôt qu'en emphase, extraits de code, liens, titres ou puces de liste, et inverse le même mappage lorsque vous collez du Markdown échappé pour retrouver des caractères ordinaires. Le décodage n'accepte que ces spéciaux connus après une barre oblique inverse et échoue clairement sur les barres finales incomplètes ou les paires d'échappement inconnues, afin que les fautes de frappe ne survivent pas silencieusement en production. Le chemin est entièrement déterministe : le même texte et le même mode produisent toujours le même résultat, sans appels réseau, sels aléatoires ni raccourcis dépendant de la date. Les contrôles simples incluent l'encodage d'une ligne avec marqueurs d'emphase en forme barre-astérisque, et le décodage d'une séquence de type lien avec crochets échappés vers la ponctuation réelle.
Ce qu'est l'échappement Markdown et ce que renvoie cet outil
Markdown traite un petit ensemble de signes de ponctuation ASCII comme marqueurs de syntaxe : astérisque et souligné pour l'emphase, accent grave pour le code, crochets et parenthèses pour les liens et images, dièse pour les titres, plus et tiret pour les listes, barre verticale pour les tableaux, chevrons pour les autoliens et le HTML, tilde pour le barré dans de nombreux dialectes, et la barre oblique inverse elle-même comme introducteur d'échappement.
CommonMark et les processeurs compatibles permettent une barre oblique inverse précédente pour neutraliser ces spéciaux afin que le caractère apparaisse littéralement dans la sortie rendue. Cette page implémente cet ensemble sur le chemin encode et l'inverse sur decode : la réponse est uniquement le contenu de chaîne transformé, sans envelopper le texte dans un squelette de document complet ni le convertir en HTML.
Contrairement à un analyseur Markdown complet, cette landing ne construit pas d'arbre de syntaxe abstraite, ne résout pas les liens de référence et n'évalue pas les blocs imbriqués ; elle répond uniquement au contrat d'échappement des caractères spéciaux.
Où l'échappement et le déséchappement Markdown s'intègrent dans les flux développeur
Les équipes de documentation et de support encodent des noms de produit et codes d'erreur dynamiques avant de les placer dans un champ Markdown afin qu'un seul souligné, accent grave ou crochet ne bascule pas l'emphase environnante ni n'ouvre un lien cassé. Les auteurs de pipelines décodent des exports riches en échappements issus de systèmes de tickets pour que le code applicatif travaille avec une ponctuation réelle plutôt qu'avec des séquences barre-astérisque.
Les ingénieurs qualité génèrent des paires encode et decode déterministes pour les tests de contrat, afin qu'un middleware qui prétend assainir le Markdown ne puisse pas basculer silencieusement vers une table d'échappement non standard entre versions. Les formateurs utilisent le même outil pour enseigner la différence entre la source Markdown, le petit ensemble de spéciaux qui contrôlent le rendu, et la règle de la barre oblique inverse qui restaure les caractères littéraux.
Cas d’usage
Extraits Markdown littéraux
Échappez titres, noms de produit et extraits utilisateur pour que astérisques, soulignés, accents graves et crochets ne déclenchent ni emphase, ni code, ni liens dans le Markdown de README et de chat.
Paires déterministes pour la CI
Générez des paires encode et decode reproductibles pour tests unitaires, contrôles de contrat et middleware qui doit respecter l'échappement littéral de style CommonMark.
Questions fréquentes
Combien coûte l'échappeur Markdown ?
Il est gratuit dans votre navigateur sur cette page.
Quels caractères sont échappés en encode ?
Encode préfixe d'une barre oblique inverse la barre, l'accent grave, l'astérisque, le souligné, les accolades, crochets, parenthèses, dièse, plus, tiret, point, exclamation, barre verticale, chevrons et tilde. Les autres caractères restent inchangés.
Que se passe-t-il si un échappement est incomplet ou illégal ?
Les barres finales isolées et les paires avec barre qui ne sont pas un spécial Markdown connu sont rejetées.
Le résultat est-il déterministe ?
Oui. Le même texte et le même mode produisent toujours le même résultat, sans réseau, aléatoire ni comportement dépendant de la date.
L'outil convertit-il le Markdown en HTML ?
Non. Il ajoute ou retire seulement les barres obliques inverses devant les caractères spéciaux et vous rend le texte lui-même. Il ne construit pas de page, ne convertit rien en HTML et ne résout aucun lien : il s'insère dans le Markdown que vous rédigez déjà.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/enc/markdown-escape \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Use *stars* and _underscores_ with `code`"}'const res = await fetch("https://api.kit.forhosting.com/enc/markdown-escape", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Use *stars* and _underscores_ with `code`"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/markdown-escape",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Use *stars* and _underscores_ with `code`"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/markdown-escape", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Use *stars* and _underscores_ with `code`"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Use *stars* and _underscores_ with `code`"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/markdown-escape", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"text": "Use *stars* and _underscores_ with `code`"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.markdown_escape",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Ce qu'est l'échappement Markdown et ce que renvoie cet outil
La réponse JSON inclut toujours result pour la chaîne transformée, mode qui reflète encode ou decode, encoding fixé à markdown, ainsi que input_length et output_length pour que les tests puissent affirmer les tailles. Encode signale aussi escapes_applied et decode signale escapes_resolved pour confirmer combien de caractères spéciaux ou de séquences d'échappement ont été réécrits. Il n'y a pas d'omission silencieuse partielle d'une séquence cassée : chaque paire avec barre est un spécial Markdown connu, sinon la requête échoue avec invalid_input.
Comment text et mode sont lus et comment les résultats restent reproductibles
Encode parcourt la chaîne par unités de code UTF-16 et préfixe uniquement les caractères de l'ensemble spécial Markdown, laissant lettres, chiffres, espaces et Unicode ordinaire inchangés pour que le texte lisible reste lisible. Comme la barre oblique inverse est elle-même un spécial et est réécrite dans le même passage de gauche à droite que les astérisques et crochets, vous obtenez un unique passage d'échappement cohérent et inversible par decode. Decode recherche les séquences menées par une barre et n'accepte qu'un caractère suivant du même ensemble spécial. Le champ de charge utile préféré est text, avec les alias input, value, s et payload afin que formulaires, chaînes de requête et clients SDK réutilisent le même contrat sans renommer de colonnes. Mode vaut encode par défaut et accepte decode explicitement ; les alias op, direction et action mappent vers le même commutateur pour les scripts qui utilisent déjà ces noms, et escape ou unescape sont acceptés comme synonymes. Une barre finale incomplète ou une barre suivie d'une lettre non spéciale lève invalid_input avec un message qui nomme le problème. Le plafond de longueur de cent mille caractères maintient la mémoire du Worker prévisible tout en couvrant corps de README, documents d'exemple et la plupart des tampons de collage. Associez l'exécution gratuite dans le navigateur sur cette page à l'API tarifée lorsque vous avez besoin du même mappage dans un pipeline automatisé sans réimplémenter les tables d'échappement Markdown. Les entrées invalides renvoient invalid_input et ne sont pas facturées, ce qui maintient la validation peu coûteuse tandis que les transformations réussies restent un prix fixe par élément de $0.002.
Où l'échappement et le déséchappement Markdown s'intègrent dans les flux développeur
Sur cette page le travail s'exécute entièrement dans votre navigateur ; via l'API chaque consultation réussie coûte $0.002, la validation en échec n'est pas facturée et rien n'est stocké après la réponse. Cette séparation—exploration interactive gratuite et API identique payante—correspond au reste du catalogue KIT de niveau A et vous permet de passer d'une démo en classe à un pipeline automatisé sans changer le résultat échappé. Associez-le à l'échappement de chaînes JSON ou au percent-encoding d'URL lorsque vous avez besoin de transformations de texte plus larges, et à d'autres endpoints d'encodage pour constituer un petit laboratoire d'outils gratuits et déterministes pour la CI et la documentation.
Cas d'intégration
Nettoyage de fixtures et d'exports
Décodez les spéciaux Markdown échappés par barre issus d'exports de tickets, journaux ou fichiers golden pour retrouver l'Unicode brut, des diffs lisibles et du code applicatif.
Questions techniques
Quels modes sont pris en charge ?
mode=encode (par défaut) transforme le texte brut en spéciaux Markdown échappés par barre. mode=decode retransforme ces échappements en caractères.