> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://doc.openagenda.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Évolution sur les conversions HTML/Markdown

Une évolution pouvant impacter l'affichage des description longues sur les sites synchronisés aura lieu le **28 octobre prochain**.

**Qui est concerné?**

Les sites reprenant via l'API OpenAgenda les variantes HTML de la description longue (en utilisant l'option `longDescriptionFormat` documentée [ici](https://developers.openagenda.com/10-lecture/))

**Nature de l'évolution**

Sur OpenAgenda, les description longues sont enregistrées au format Markdown: l'évolution concerne la manière dont les retours à la ligne sont convertis vers le format HTML.

Actuellement, un retour à la ligne saisi dans le formulaire OpenAgenda marque la séparation entre le paragraphe en cours et le suivant soit deux balises `<p>` successives sur la variante HTML.

Mais en pratique, nous constatons régulièrement l'usage de deux retours à la ligne successifs pour mieux marquer une séparation entre deux sections de textes ce qui a pour conséquence l'apparition de paragraphes vides dans la variante HTML de la description.

L'évolution propose de prendre en compte cette pratique et d'utiliser une balise `<br>` pour les retours à la ligne simples et de ne marquer la séparation entre deux paragraphes que par les retours à la ligne doubles.

**Impact**

Il est à priori minime, l'affichage de balises `<br>` étant généralement géré par défaut. Il sera utile de vérifier le bon espacement entre paragraphes une fois que les balises `<p>` vides auront été remplacées par des paragraphes simples incluant des `<br>`.