Programme Leçon 208 sur 250 · Projets : construire de vraies choses
Projets : construire de vraies choses

Projet : Markdown -> HTML

Chaque appli de notes, chaque README et chaque zone de discussion qui affiche du Markdown fait tourner une fonction très proche de celle que tu vas écrire. Tu vas construire to_html(md) : prendre une chaîne Markdown et renvoyer une chaîne HTML. C'est un vrai parseur, et la partie intéressante, ce sont les blocs qui s'étendent sur plusieurs lignes : une suite de puces devient une seule liste, et une suite de lignes de texte devient un seul paragraphe.

L'astuce qui rend ça propre est une boucle tampon puis vidage (buffer-and-flush). Tu parcours les lignes une par une. Les lignes à puce s'empilent dans un tampon de liste ; les lignes de texte dans un tampon de paragraphe. Quand tu tombes sur une ligne qui termine le bloc en cours (une ligne vide, un titre, ou un autre type de bloc), tu vides le tampon en un bloc HTML terminé.

blocks, para, items = [], [], []
for line in md.split("\n"):
    s = line.strip()
    if s == "":
        flush_list(); flush_para()   # blank line ends any open block
    elif s.startswith("- "):
        items.append(s[2:])          # keep collecting bullets
    else:
        ...

Les règles (échappées ici pour que tu puisses lire les balises) :

  • # text -> <h1>text</h1>
  • ## text -> <h2>text</h2>
  • des lignes - item consécutives -> une seule <ul><li>item</li>...</ul>
  • des suites de texte séparées par des lignes vides -> un <p>...</p> chacune (relie les lignes par un espace)
  • **bold** n'importe où -> <strong>bold</strong>

Gère le gras en ligne avec une seule regex : re.sub(r"\*\*(.+?)\*\*", r"<strong>\1</strong>", text) et applique-la au texte de chaque bloc. Assemble les blocs terminés sans séparateur. Fais attention aux cas limites vérifiés par les tests : du gras dans un titre, une liste qui suit directement un titre sans ligne vide, et des lignes vides parasites au début ou à la fin. Appuie sur Run pour transformer un document entier en HTML.

À ton tour

Écris to_html(md) qui convertit du Markdown en chaîne HTML : les titres # H1 et ## H2, les lignes - item consécutives en une seule <ul>, le texte séparé par des lignes vides en paragraphes <p> (lignes reliées par un espace), et **bold** en <strong>. Utilise une boucle tampon puis vidage pour que les blocs sur plusieurs lignes se regroupent correctement.

Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon

Cet exercice s'ouvre bientôt

Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.