Open Time

Objectif : Reprendre le mémento du wiki Dotclear et voir comment obtenir l’équivalent avec Markdown… Puis ensuite indiquer les possibilités supplémentaires avec Markdown.

Note : Le symbole ⎵ représente une espace standard.

Marqueurs de début de ligne

Titres

Niveau 3 = ###⎵ + Titre
Niveau 4 = ####⎵ + Titre
Niveau 5 = #####⎵ + Titre
(les niveaux 1 et 2 sont réservés au titre du blog et au titre du billet)

Listes

Numérotées = 1.⎵ + élément de liste
Non numérotées = *⎵ + élément de liste ou -⎵ + élément de liste

2e niveau = ⎵⎵⎵⎵1.⎵ ou ⎵⎵⎵⎵*⎵ / ⎵⎵⎵⎵-⎵ + élément de liste
(indentation = 4 espaces)

Exemple :

* Premier niveau - 1  
    42. Deuxième niveau - 1  
    42. Deuxième niveau - 2  
* Premier niveau - 2  

Donne :

Définitions/Descriptions

Terme = terme
Définition = :⎵ + définition/description

Exemple :

retraite
: c'est quand tu bosses plus pour le patronnat
: c'est quand t'as été mauvais dans la bataille et que tu te tires pour sauver ta life

Donne :

Bloc détail

Pas d’équivalence, il faut utiliser du HTML, exemple :

<details open>
<summary>Titre du bloc détail</summary>
Contenu du bloc détail
</details>

Donne :

Divers

Trait horizontal = ----

Texte préformatté = ⎵⎵⎵⎵ + texte

Bloc de citation = >⎵ + texte, exemple :

> Footer de merde !

Donne :

Bloc de côté = pas d’équivalence, il faut utiliser du HTML, exemple :

<aside>
Contenu du bloc de côté
</aside>

Abréviations

*[ + abréviation + ]: + titre (optionnel)
Les abréviations sont appliquées partout dans le texte et sont ensuite supprimées du résultat final.

Exemple :

The HTML specification is maintained by the W3C.

*[HTML]: Hyper Text Markup Language

Donne :

Bloc HTML

Insérer directement le code HTML.

Marqueurs en fin de ligne

Retour à la ligne = ⎵⎵ (2 espaces)

Attributs HTML

Utiliser { [.classe] [#id] [attribut=valeur] } en fin de (1re) ligne
Valable pour les titres, images, liens, blocs de code.

Exemple :

[Lien en anglais](https://michelf.ca/projects/php-markdown/){hreflang=en}  

```language-javascript { .sample }
let i = null;
```

Donne :

let i = null;

Marqueurs indépendants de la position

Emphase = * + texte + *
Forte emphase = ** + texte + **

Insertion = pas d’équivalence, il faut utiliser du HTML = <ins> + texte + </ins>
Suppression = pas d’équivalence, il faut utiliser du HTML = <del> + texte + </del>
Marqueur = pas d’équivalence, il faut utiliser du HTML = <mark> + texte + </mark>

Exposant = pas d’équivalence, il faut utiliser du HTML = <sup> + texte + </sup>
Indice = pas d’équivalence, il faut utiliser du HTML = <sub> + texte + </sub>

Lien = ( + url + )
            [ + nom + ]( + url + )
            [ + nom + ]( + url + “titre” + )
            [ + nom + ]( + url + ){ lang= + langue + }
            [ + nom + ]( + url + “titre” + ){ lang= + langue + }

Image = ![ + nom + ]( + url + )
Pas d’équivalence pour les formes plus complexes (positionnées et/ou avec titre, légende, …) ; dans ce cas il faut utiliser du HTML, exemple :

![Avatar](/public/avatar.jpg)

<img src="/public/avatar.jpg" alt="" style="margin: 0 auto; display: block;" />

Donne :

ancre = pas d’équivalence, utiliser du HTML, exemple : <a id=" + ancre + "> + texte + </a>

Citation = pas d’équivalence, utiliser du HTML, exemple : <q> + citation + </q>

Code = ` + code ici + `

Locution étrangère = pas d’équivalence, utiliser du HTML, exemple : <i lang=" + langue + "> + locution + </i>

Note = [^ + id + ]
[^ + id + ]:⎵ + Corps de la note.

Exemple :

Markdown est potentiellement plus souple que le wiki Dotclear[^1].

[^1]: Mais le wiki Dotclear peut embarquer du Markdown alors que le contraire n'est pas vrai.

Donne :

Litéral = \ + caractère (empêche l’interprétation d’un code Markdown)

Span HTML = pas d’équivalence, insérer directement le code HTML

Code HTML = pas d’équivalence, insérer directement le code HTML

Spécifique à Markdown

Blocs de code

``` + [ language- + langage ]
Contenu du code
```

Tables

Exemple :

First Header  | Second Header
------------- | -------------
Content Cell  | Content Cell
Content Cell  | Content Cell

Donne :

Alignement, exemple :

À gauche | À droite | Centré
:--------- | -----:|:--------:
Computer  | $1600 | x
Phone     |   $12 | - 
Pipe      |    $1 | -

HTML et Markdown

Un bloc HTML peut contenir du contenu utilisant la syntaxe Markdown, à condition d’ajouter l’attribut markdown="1" au bloc. Dans certains cas, table de cellule par exemple (lorsqu’il y a risque de confusion), seuls les éléments en ligne seront interprétés. Dans ce cas utiliser markdown="block" comme attribut de bloc.

Exemple :

<p>Texte en **gras** et texte en *italique* dans un bloc HTML</p>

Donne :

Et avec l’attribut, exemple :

Exemple :

<p markdown="1">Texte en **gras** et texte en *italique* dans un bloc HTML</p>

Donne :