CodeBlanks Logo Icon CodeBlanks

Markdown

Markdown ile dokümantasyon biçimleme öğrenirsin.

Markdown

Doc comment'lar Markdown biçimini destekler. Başlıklar #, kalın **, italik * ve kod blokları ``` ile yazılır.

dartdoc bunları HTML'e çevirir. Örnek: ## Başlık, **önemli**, `kod`. Bu, dokümantasyonu zengin ve okunaklı yapar.

Listeler için - tire, satır içi kod için tek tırnak kullanılır. Aşırıya kaçmadan biçimlendirme önerilir.

Markdown örneği

Bir doc comment içinde Markdown: ilk satır /// # Hesaplama, boşluk, sonra /// Bu fonksiyon **hızlı** toplama yapar.

Kod örneği için üç tırnakla blok açılır: /// ```dart ... /// ```. dartdoc bunu renklendirilmiş HTML olarak gösterir.

Boş /// satırı paragraf ayracı olarak kullanılır; okunabilirliği artırır.

Uygulama Markdown doc comment

int multiply(int a, int b) => a * b; fonksiyonunu yaz. Üzerine doc comment ekle: birinci satır /// # Çarpma, ikinci satır /// **hızlı** işlem.. main içinde print(multiply(3, 4)) çağır.

Başlangıç kodu

main.dart
// multiply fonksiyonunu ve markdown doc comment'ini yaz

void main() {
  // multiply(3, 4) sonucunu yazdır
}

Örnek çözüm

main.dart
/// # Çarpma
/// **hızlı** işlem.
int multiply(int a, int b) => a * b;

void main() {
  print(multiply(3, 4));
}

Beklenen çıktı

12

Soru ve cevaplar

Dersin sorularını cevaplarıyla birlikte inceleyebilirsin. Kendini denemek istersen dersi interaktif olarak çöz.

1 Markdown biçimleri

Kavram Anlamı
# Başlık Başlık
**kalın** Kalın
*italik* İtalik
`kod` Kod

2 Markdown'da kalın yazı nasıl işaretlenir?

  • {kalın}
  • <<kalın>>
  • **kalın** Doğru cevap
  • //kalın//

Açıklama: ** ile sarılan metin kalın olur.

3 Markdown başlık

Soru
/// ____ Hesaplama
Cevap
/// # Hesaplama

Açıklama: # birinci düzey başlıktır.

Orta seviye bölümündeki tüm dersler