Markdown bir yazı biçimidir. HTML bir yayınlama biçimidir. Dolayısıyla, Markdown söz dizimi, HTML'nin tam çok yönlülüğünü sunmak için değil, yazılı metinde yalnızca en yaygın olan öğeleri sunmaktır. Daha karmaşık bir işlem yapmanız gerektiğinde, bir Markdown dosyasında DevSite tarafından desteklenen herhangi bir satır içi HTML etiketini ve blok düzeyinde etiketleri kullanabilirsiniz. Markdown'dan HTML'ye geçiş yaptığınızı belirtmenize gerek yoktur. HTML etiketini aşağıdaki örnekte olduğu gibi kullanmanız yeterlidir.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Satır içi HTML
Satır içi HTML etiketleri bir Markdown paragrafı, liste öğesi veya başlığı içinde kullanılabilir.Ayrıca, Markdown söz dizimini de (ör. **strong**, *emphasis* vb.) Bu, aşağıdaki örnekte gösterildiği gibi, bir koda dikkat çekmek istediğinizde yararlı olur.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
Blok düzeyinde HTML
DevSite tarafından desteklenen blok düzeyinde HTML etiketleri, etrafındaki içerikten boş bir satırla ayrılmalıdır. Satır içi HTML etiketlerinin aksine, Markdown söz dizimi (ör. **strong**, *emphasis* vb.) aşağıdaki örnekte olduğu gibi oluşturulmaz.
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.
En iyi uygulamalar
DevSite'da oluşturma hatalarını önlemek için Markdown dosyalarında HTML'yi aşağıdaki şekillerde biçimlendirmenizi öneririz.
Desteklenmeyen blok düzeyinde HTML etiketleri kullanmayın DevSite, birçok blok düzeyinde HTML etiketini destekler. ancak desteklenmeyen bir tane eklendiğinde HTML'niz metin olarak oluşturulur veya kodu bozar.
Girintiyi artırırken fazladan sekme veya boşluk eklemeyin Blok düzeyindeki başlangıç ve bitiş etiketlerinin girintisi, sekme veya boşlukla doldurulmamalıdır. Bazı düzenleyiciler otomatik olarak fazladan sekme veya boşluk ekler. Dikkat edin!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Girintilendirilmemiş kodun göreceli olduğunu unutmayın
Örneğin, Markdown'da liste oluştururken blok düzeyinde başlangıç ve bitiş etiketlerine girinti eklemeniz gerekmez.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
Başlangıç ve bitiş etiketleri arasına boş satır eklemeyin
Markdown ve HTML arasında geçiş yaparken bu işlemi kolayca yapabilirsiniz. Ancak basit bir boş satır, sayfayı kolayca hatalı bir şekilde oluşturabilir.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.