Markdown ist ein Schreibformat. HTML ist ein Veröffentlichungsformat. Daher ist die Markdown-Syntax nicht dafür gedacht, die volle Vielseitigkeit von HTML zu bieten, sondern nur die gängigsten Elemente für geschriebenen Text. Für komplexere Aufgaben können Sie beliebige Inline-HTML-Tags und Tags auf Blockebene verwenden, die von der DevSite in einer Markdown-Datei unterstützt werden. Sie müssen nicht angeben, dass Sie von Markdown zu HTML wechseln. Verwenden Sie einfach das HTML-Tag wie im folgenden Beispiel.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Inline-HTML
Inline-HTML-Tags können in Markdown-Absätzen, Listenelementen oder Überschriften verwendet werden und auch Markdown-Syntax (z.B. **strong**, *emphasis* usw.) Dies ist hilfreich, wenn Sie die Aufmerksamkeit auf Code wie im nachfolgenden Beispiel lenken möchten.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML auf Blockebene
HTML-Tags auf Blockebene, die von der DevSite unterstützt werden, müssen durch eine Leerzeile vom umgebenden Inhalt getrennt werden. Im Gegensatz zu Inline-HTML-Tags kann die Markdown-Syntax (z.B. **strong**, *emphasis* usw.) in HTML-Tags auf Blockebene werden nicht wie im Beispiel unten gerendert.
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.
Best Practices
Wir empfehlen, HTML in Markdown-Dateien folgendermaßen zu formatieren, um Renderingfehler auf der DevSite zu vermeiden.
Keine nicht unterstützten HTML-Tags auf Blockebene verwenden Die DevSite unterstützt viele HTML-Tags auf Blockebene. Wenn Sie jedoch eine nicht unterstützte URL einfügen, wird der HTML-Code entweder als Text gerendert oder der Code beschädigt.
Beim Einrücken keine zusätzlichen Tabulatoren oder Leerzeichen hinzufügen Start- und End-Tags auf Blockebene sollten nicht mit Tabulatoren oder Leerzeichen eingerückt werden. Einige Bearbeiter fügen automatisch zusätzliche Tabs oder Leerzeichen hinzu – Vorsicht!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Denken Sie daran, dass Code ohne Einzug
Beispielsweise müssen Sie beim Erstellen von Listen in Markdown keine Start- und End-Tags auf Blockebene einrücken.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
Zwischen Start- und End-Tag keine Leerzeile einfügen
Das ist ganz einfach, wenn Sie zwischen Markdown und HTML wechseln, aber eine einfache Leerzeile kann eine Seite leicht falsch darstellen.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.