A Markdown egy írási formátum; A HTML egy publikációs formátum. Így a Markdown szintaxis nem a HTML teljes sokoldalúságát kínálja, csak az írott szöveg leggyakoribb elemeit. Ha valami bonyolultabbat kell tennie, használhat bármilyen soron belüli HTML-címkét és blokkszintű címkét, amelyet a DevSite támogat a Markdown-fájlban. Nem szükséges jelezni, hogy Markdownról HTML-re vált, csak használja a HTML címkét az alábbi példában látható módon.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Inline HTML
A soron belüli HTML címkék használhatók Markdown bekezdésben, listaelemben vagy fejlécben, és tartalmazhatnak Markdown szintaxist (pl. **strong** , *emphasis* stb.) Ez akkor hasznos, ha fel akarja hívni a figyelmet egy kis kódot, mint az alábbi példában.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
Blokk szintű HTML
A DevSite által támogatott blokkszintű HTML-címkéket üres sorral kell elválasztani a környező tartalomtól. És a soron belüli HTML-címkékkel ellentétben a blokkszintű HTML-címkék Markdown szintaxisa (pl. **strong** , *emphasis* stb.) nem az alábbi példában látható módon jelenik meg.
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.
A legjobb gyakorlatok
Javasoljuk, hogy a Markdown-fájlok HTML-kódját az alábbi módokon formázza, hogy megelőzze a DevSite-on történő megjelenítési hibákat.
Ne használjon nem támogatott blokkszintű HTML-címkéket. A DevSite számos blokkszintű HTML-címkét támogat; de ha egy nem támogatottat tartalmaz, akkor vagy szövegként jeleníti meg a HTML-kódot, vagy megtöri a kódot.
Ne adjon hozzá extra tabulátorokat vagy szóközöket a behúzáskor. A blokkszintű kezdő és záró címkéket nem szabad tabulátorral vagy szóközzel behúzni. Egyes szerkesztők automatikusan további tabulátorokat vagy szóközöket adnak hozzá – vigyázat!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Ne felejtsük el, hogy a behúzatlan kód relatív
Például nem kell behúznia a blokkszintű kezdő és záró címkéket, amikor listákat hoz létre a Markdown alkalmazásban.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
Ne írjon be üres sort a kezdő és záró címke közé
Ez könnyen megtehető, amikor a Markdown és a HTML között vált, de egy egyszerű üres sor könnyen hibásan jelenítheti meg az oldalt.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.