Markdown adalah format penulisan; HTML adalah format penerbitan. Dengan demikian, sintaks Markdown tidak dimaksudkan untuk menawarkan keserbagunaan penuh HTML, hanya elemen yang paling umum untuk teks tertulis. Ketika Anda perlu melakukan sesuatu yang lebih rumit, Anda dapat menggunakan tag HTML inline dan tag tingkat blok yang didukung oleh DevSite dalam file Markdown. Tidak perlu menunjukkan bahwa Anda beralih dari Markdown ke HTML, cukup gunakan tag HTML seperti pada contoh di bawah ini.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
HTML sebaris
Tag HTML inline dapat digunakan dalam paragraf, item daftar, atau header Markdown, dan juga dapat berisi sintaksis Markdown (misalnya, **strong**, *emphasis*, dll.) Ini berguna saat Anda ingin menarik perhatian ke sedikit kode, seperti pada contoh di bawah ini.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML tingkat blok
Tag HTML tingkat blok yang didukung oleh DevSite harus dipisahkan dari konten di sekitarnya dengan baris kosong. Dan tidak seperti tag HTML inline, sintaks Markdown (misalnya, **strong**, *emphasis*, dll.) di tag HTML tingkat blok tidak dirender seperti dalam contoh di bawah.
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.
Praktik terbaik
Sebaiknya format HTML dalam file Markdown dengan cara berikut untuk mencegah kesalahan rendering di DevSite.
Jangan gunakan tag HTML tingkat pemblokiran yang tidak didukung DevSite mendukung banyak tag HTML tingkat blok; namun menyertakan yang tidak didukung akan membuat HTML Anda sebagai teks atau merusak kode.
Jangan tambahkan tab atau spasi tambahan saat membuat indentasi Tag awal dan akhir tingkat blok tidak boleh diindentasi dengan tab atau spasi. Beberapa editor menambahkan tab atau spasi tambahan secara otomatis — hati-hati!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Jangan lupa bahwa kode yang tidak diindentasi bersifat relatif
Misalnya, Anda tidak perlu mengindentasi tag awal dan akhir tingkat blok saat membuat daftar di Markdown.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
Jangan tambahkan baris kosong antara tag awal dan akhir
Ini mudah dilakukan ketika Anda beralih antara Markdown dan HTML, tetapi baris kosong sederhana dapat dengan mudah merender halaman secara tidak benar.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.