Markdown: görünümden önce metnin yapısını düzenleyin
Markdown, kaynak dosyası okunabilir metin olarak kaldığı için notlarda ve belgelerde yararlıdır. Değeri çok sayıda işaret eklemekte değil; başlık, paragraf ve listeyi ayırmaktadır.
Başlık yalnızca büyük yazı değildir
Belgenin konusuyla başlayıp alt bölümleri daha düşük başlık düzeyine yerleştirin. Boşlukla izlenen # ve ## farklı düzeylerdir; her satırı ana başlık yapmak bu hiyerarşiyi siler.
Ayrı maddeler için liste, aralarındaki ilişkiyi açıklamak için paragraf kullanın. Biçimlendirme açık anlatımı desteklemeli, onun yerine geçmemelidir.
Kaynaklar: CommonMark 0.31.2 — Structured text, headings and rendering differences
Önizleme her yayın ortamını temsil etmez
Markdown uzantıları sistemlere göre değişir. Bir düzenleyicide çalışan tablo başka yerde aynı görünmeyebilir; okuyucunun kullanacağı ortamı kontrol edin.
ToolRoof HTML önizler ve dışa aktarır, ancak girilen ham HTML kodunu çalıştırmaz. Dış görsellerin yerine açıklamaları görünür; önizlemede bağlantılar etkin değildir. Tam web sayfası kopyası oluşturmaz.
Kaynaklar: CommonMark 0.31.2 — Structured text, headings and rendering differences
Görüntülenen kopyanın yanında kaynağı da saklayın
Markdown kaynağı sonraki değişiklikleri karşılaştırmayı kolaylaştırır. HTML sunum içindir; geri dönüşüm özgün kaynağı birebir yeniden üretmeyebilir.
Paylaşmadan önce içeriği ve bağlantıları inceleyin. Önizleme bilgi doğruluğu, bağlantı güvenliği veya başkasının içeriğini kullanma hakkı sağlamaz.
Örnek: kısa bir toplantı notu
# Haftalık plan, ardından ## Öncelikler, sonra ayrı satırlarda - Özeti incele ve - Taslağı gönder yazın. Çıktı birbirine benzeyen 4 paragraf değil; ana başlık, alt başlık ve 2 maddelik listedir.
Boşluksuz #Haftalık plan ATX başlığı oluşturmaz. Ters tırnak içindeki kod metin olarak gösterilir; önizlenmesi çalıştırıldığı veya doğru olduğu anlamına gelmez.