Markdown est un format d'écriture ; HTML est un format de publication. Ainsi, la syntaxe Markdown n'est pas destinée à offrir toute la polyvalence du HTML, mais uniquement les éléments les plus courants pour du texte écrit. Lorsque vous devez effectuer une opération plus complexe, vous pouvez utiliser n'importe quelle balise HTML intégrée et toute balise au niveau du bloc compatibles avec DevSite dans un fichier Markdown. Il n'est pas nécessaire d'indiquer que vous passez de Markdown à HTML. Utilisez simplement la balise HTML comme dans l'exemple ci-dessous.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Intégrer le code HTML
Les balises HTML intégrées peuvent être utilisées dans un paragraphe, un élément de liste ou un en-tête Markdown, et peuvent également contenir la syntaxe Markdown (par exemple, **strong**, *emphasis*, etc.) Cela est utile lorsque vous souhaitez attirer l'attention sur un peu de code, comme dans l'exemple ci-dessous.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
Code HTML au niveau du bloc
Les balises HTML au niveau du bloc qui sont compatibles avec DevSite doivent être séparées du contenu environnant par une ligne vide. Et contrairement aux balises HTML intégrées, la syntaxe Markdown (par exemple, **strong**, *emphasis*, etc.) dans les balises HTML au niveau du bloc ne s'affichent pas comme dans l'exemple ci-dessous.
This is a Markdown paragraph that explains Java format strings:
// required blank line
<pre>
System.out.format("The square of *%d* is *%f*.*%n*", i, r);
</pre>
// required blank line
This is another Markdown paragraph.
Bonnes pratiques
Nous vous recommandons de mettre en forme le code HTML dans les fichiers Markdown comme suit pour éviter les erreurs d'affichage sur DevSite.
N'utilisez pas de balises HTML non compatibles au niveau du bloc. DevSite prend en charge de nombreuses balises HTML au niveau du bloc : mais si vous en incluez un qui n'est pas pris en charge, soit votre code HTML s'affiche sous forme de texte, soit le code ne fonctionne pas.
N'ajoutez pas de tabulations ni d'espaces supplémentaires lors du retrait Les balises de début et de fin au niveau du bloc ne doivent pas être mises en retrait avec des tabulations ou des espaces. Certains éditeurs ajoutent automatiquement des tabulations ou des espaces supplémentaires. Attention !
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
N'oubliez pas que le code sans retrait est relatif
Par exemple, lorsque vous créez des listes dans Markdown, vous n'avez pas besoin de mettre en retrait les balises de début et de fin au niveau du bloc.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
N'ajoutez pas de ligne vide entre une balise de début et une balise de fin.
C'est facile à faire lorsque vous basculez entre Markdown et HTML, mais une simple ligne vide peut facilement afficher une page de manière incorrecte.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.