Utiliser le format Markdown dans Airtable

Le format Markdown est une syntaxe légère et lisible, utilisée pour mettre en forme du texte. Vous pouvez avoir besoin de mettre en forme du texte dans Airtable lorsque vous cherchez à attirer l’attention sur une information spécifique ou à afficher des informations d’une manière plus esthétique. Que vous débutiez avec le format Markdown ou non, cet article vous aidera à mieux comprendre où et comment implémenter la version du format Markdown d’Airtable.

Présentation

Actuellement, il existe cinq principales utilisations du format Markdown dans Airtable.

• Guides sur la base : créez une description stylisée de votre base.
• Champ de texte long au format de texte enrichi : pour voir les options de syntaxe Markdown disponibles, consultez la page Mise en forme de texte enrichi dans le champ de texte long. 
• Extension Web Clipper : lorsque vous effectuez une capture, tout format Markdown ajouté au texte avant l’envoi sera inclus dans les champs de texte long au format de texte enrichi.
• Actions d’automatisation : pour envoyer des e-mails avec du contenu mis en forme.
• API Airtable : pour voir des exemples de format Markdown dans un champ de texte long contenant du texte enrichi dans l’API, consultez la page Texte long au format de texte enrichi dans l’API.

Tableau de référence Markdown

Toutes les syntaxes Markdown ne seront pas nécessairement disponibles pour les cinq utilisations répertoriées précédemment. Nous espérons que le tableau de référence suivant peut permettre d’éclaircir certaines distinctions d’utilisation importantes. Faites particulièrement attention aux cases cochées qui comportent un astérisque. Celui-ci indique des mises en garde dont vous devez prendre connaissance. De plus, vous pouvez faire défiler le tableau ci-dessous vers la droite ➡️ pour voir d’autres utilisations du produit.

¹  Il doit y avoir une espace entre les crochets et après [ ]  pour faire apparaître la case à cocher Markdown. Cet espace est particulièrement important pour les workflows pour lesquels vous utilisez une API.

² Vous ne pouvez pas créer d’éléments de liste en alinéa exclusivement via le format Markdown dans des champs de texte long. Cependant, vous pouvez appuyer sur les touches Retour et Tab après un élément de la liste pour créer un élément de liste en alinéa.

³ Dans les champs de texte long, pour commencer un bloc de code, il vous suffit d’appuyer sur les trois premières marques puis sur la touche Retour/Entrée. Pour terminer un bloc de code, vous devrez cliquer sur l’option correspondante du menu de texte enrichi.

 ⁴ L’API Airtable crée des caractères d’échappement supplémentaires pour résoudre les problèmes liés au format lorsque vous extrayez des données. Si la sortie de cette API est ensuite réinsérée dans Airtable, elle n’ignorera pas efficacement le format Markdown.

Options de syntaxe

Il existe actuellement 12 options de syntaxe disponibles afin d’utiliser le format Markdown pour mettre en forme du texte dans Airtable. Cliquez sur l’un des liens ci-dessous pour accéder directement à la section dédiée à cette syntaxe Markdown :

Titres

Une ligne qui commence par un à trois caractères #  suivis d’une espace, donnera lieu à un titre de niveau un à trois.

Syntaxe Markdown

# First level header ## Second level header ### Third level header` 

Résultat

Gras et italique

Le texte entouré par une seule paire de caractères * ou _ sera mis en forme en italique (exprime l’emphase en format Markdown). Le texte entouré par une double paire de caractères **ou __ sera mis en forme en gras (exprime une emphase plus importante en format Markdown). Vous pouvez les combiner avec d’autres formats incorporés.

Syntaxe Markdown

*This text will be italic* _This will also be italic_  **This text will be bold** __This will also be bold__  _**Combine them for bold italic**_ 

Résultat

Ce texte sera en italique
Ceci sera aussi en italique

Ce texte sera en gras 
Ceci sera aussi en gras

Combinez-les pour un texte en gras italique

Barré

Le texte entouré d’une paire de caractères ~~ sera barré. Ce format n’est pas pris en charge dans la description de la base.

Syntaxe Markdown

~~This text will be strikethrough~~ 

Résultat

Case à cocher

Commencer une ligne par « [ ] » ou « [x] » permet de créer une liste de cases à cocher.

Syntaxe Markdown

[x] Checked item 1 [ ] Unchecked item 2     [x] Subitem 1     [ ] Subitem 2` 

Résultat

Liste en désordre

Vous pouvez utiliser -ou * comme marqueur de liste en désordre.

Syntaxe Markdown

- Item 1 - Item 2     * Indented item 1     * Indented item 2` 

Résultat

• Élément 1
• Élément 2
  • Élément en alinéa 1
  • Élément en alinéa 2

Liste ordonnée

Commencer une ligne par un nombre et un point permet de la convertir automatiquement en liste.

Syntaxe Markdown

1. Item 1 2. Item 2     1) Item 2a     2) Item 2b 

Résultat

1. Élément 1
2. Élément 2
   1. Élément 2a
   2. Élément 2b

Hyperliens

Il existe deux types de liens, dans le texte et de référence  :

• Un lien dans le texte prend la forme [Link text](link URL), où l’URL est indiquée dans le texte.
• Un lien de référence prend la forme [Link Text][Label Name], où le libellé fait référence à une définition du lien.
  • Une définition de lien est une ligne avec la forme [Label name]: URL. Elle peut être placée n’importe où dans le texte et sera supprimée lorsqu’elle sera convertie en valeur de cellule de texte enrichi.

Syntaxe Markdown

[Airtable](https://airtable.com) is awesome. [Link reference][1] also works.  [1]: [https://daringfireball.net/projects/markdown/syntax#link](https://daringfireball.net/projects/markdown/syntax#link) 

Résultat

Airtable est incroyable.
Le lien de référence fonctionne également.

Blocs de citation

Un bloc de citation est une ligne qui commence par > et qui est suivie par le contenu de la citation. Ce format n’est pas pris en charge dans la description de la base.

Syntaxe Markdown

> Roses are red > Violets are blue 

Résultat

Les roses sont rouges > les violettes sont bleues

Code incorporé

Le texte entouré d’une paire de caractères ` sera mis en forme en tant que code incorporé (avec un caractère à chasse unique).

Syntaxe Markdown

`apiKey` is your secret API token. 

Résultat

apiKey est votre jeton d’API secret.

Bloc de code

Un bloc de code est constitué d’une ou plusieurs lignes de code entourées par des marques de code. Une marque de code est une ligne formée d’une séquence d’au moins trois apostrophes inversées (`) ou tildes (~). La marque de code de fin doit être du même type (apostrophes inversées ou tildes) et comporter au moins le même nombre de caractères que la marque de début.

La ligne avec la marque de code de début peut potentiellement contenir du texte à la suite de la marque. Elle est alors appelée chaîne d’informations. Certaines implémentations de format Markdown utilisent cette chaîne pour mettre en valeur une syntaxe de bloc de code. Actuellement, Airtable n’utilise pas la chaîne d’information. Celle-ci sera donc ignorée lors de la conversion du texte Markdown en valeur de cellule de texte enrichi.

Syntaxe Markdown

``` tell application "Microsoft Excel"     quit end tell ```

Résultat

tell application "Microsoft Excel" quit end tell 

Échappement du format Markdown

Vous pouvez utiliser une barre oblique inverse (\) avant un caractère de syntaxe Markdown afin d’ignorer la mise en forme.

Syntaxe Markdown

\*This is not italic\* 

Résultat

Ceci n’est pas de l’italique

Sauts de ligne

Chaque saut de ligne sera considéré comme un retour à la ligne. Notez que ce comportement diffère du format Markdown original.

Syntaxe Markdown

The Sea of Faith Was once, too, at the full, and round earth’s shore Lay like the folds of a bright girdle furled. But now I only hear Its melancholy, long, withdrawing roar, Retreating, to the breath Of the night-wind, down the vast edges drear And naked shingles of the world. 

Résultat

Que voulez-vous la porte était gardée
Que voulez-vous nous étions enfermés
Que voulez-vous la rue était barrée
Que voulez-vous la ville était matée
Que voulez-vous elle était affamée
Que voulez-vous nous étions désarmés
Que voulez-vous la nuit était tombée
Que voulez-vous nous nous sommes aimés.

Sauts de ligne multiples

Nous prenons en charge la balise HTML <br> pour l’envoi d’e-mails demandant plusieurs sauts de ligne.

Exemple

test <br> <br> test 

Résultat

FAQ

D’autres options de mise en forme de texte sont-elles disponibles ?

Sauf si indiqué précédemment, les formats de texte pour d’autres types de données (par exemple, devises, dates, nombres) ne sont pas disponibles actuellement.

Lorsque j’utilise les actions d’automatisation qui prennent en charge le format Markdown, puis-je utiliser le format Markdown pour modifier la manière dont les saisies de champs dynamiques sont affichées ?

Oui, vous pouvez utiliser le format Markdown avec les champs d’automatisation. Ajoutez simplement le format Markdown autour du champ que vous référencez, comme dans l’exemple ci-dessous.

Le format Markdown d’Airtable est-il compatible avec d’autres formats Markdown ?

Le format Markdown dans Airtable n’est pas compatible avec les deux formats Markdown les plus connus : Markdoc et Github Flavored Markdown. Par conséquent, vous devrez peut-être faire des tests ou créer des solutions lorsque vous tentez de créer des URL.

Puis-je utiliser du HTML ?

Vous pouvez utiliser les balises HTML dans certaines automatisations (par ex. pour mettre en forme des e-mails via l’action Envoyer un e-mail), mais le langage HTML n’est pas pris en charge de manière native dans le produit actuellement.