Markdown nedir? Ders notu ve sunum için kısa bir giriş
Markdown, düz metni birkaç işaretle biçimlendiren bir yazım biçimidir: # Başlık, **kalın**, - madde, [bağlantı](adres), . Bir .md dosyası her metin editöründe açılır, her sürüm kontrol sistemi karşılaştırabilir ve tek komutla HTML, PDF, Word ya da Marp ile slayta çevrilir. Ders notu, izlence ve slayt için uygun olmasının nedeni budur: içerik metindir, biçim araca bırakılır.
Bu yazı temel söz dizimini, Markdown'ın öğretim için neden işe yaradığını, dosyayı açıp dönüştürmeyi, Marp ile slayt yazmayı ve editör seçeneklerini anlatır.
Temel söz dizimi
# Birinci düzey başlık
## İkinci düzey başlık
Bir paragraf. **Kalın**, *eğik*, `kod`.
- madde
- madde
- alt madde
1. sıralı
2. liste
[Bağlantı metni](https://ornek.edu)
> Alıntı
| Sütun | Sütun |
|---|---|
| hücre | hücre |
Kod blokları üç ters tırnakla açılıp kapanır; dilin adı yazılırsa renklendirilir. Matematik çoğu araçta $x^2$ ile yazılır. Tamamı birkaç dakikada öğrenilir; gerisi alışkanlıktır.
Neden ders için?
- Aranabilir. Bir dönemin bütün notlarında bir terimi aramak tek komuttur; PowerPoint ve Word'de dosya dosya açarsınız.
- Karşılaştırılabilir. Geçen yılın notuyla fark satır satır görünür (git ile ders slaytları, İngilizce).
- Yeniden üretilebilir. Aynı metinden PDF, HTML, Word ve slayt çıkar; içerik bir yerde durur.
- Uzun ömürlü. Düz metin yirmi yıl sonra da açılır; özel biçimler aracın sürümüne bağlıdır.
- Yardımcı dostu. Bir yapay zeka yardımcısı metni okuyabilir, atıfla düzenleyebilir; ikili dosyayı okuyamaz.
.md dosyası nasıl açılır, nasıl çevrilir?
Açmak: herhangi bir metin editörü (VS Code, Not Defteri, TextEdit), Obsidian, Typora gibi Markdown editörleri, ya da GitHub'da doğrudan görüntüleme. Çevirmek:
pandoc notlar.md -o notlar.pdf # PDF (LaTeX ya da bir HTML motoru gerekir)
pandoc notlar.md -o notlar.docx # Word
pandoc notlar.md -o notlar.html # HTML
pandoc ücretsiz bir dönüştürücüdür ve Markdown'ı neredeyse her biçime çevirir. VS Code'un Markdown önizlemesi (⇧⌘V) ve "PDF olarak yazdır" eklentileri de yaygın yoldur.
Markdown ile slayt: Marp
Marp, Markdown'ı slayta çevirir: dosyanın başına marp: true, slaytlar arasına ---, notlar HTML yorumu olarak.
---
marp: true
paginate: true
---
# İlk slayt
---
## İkinci slayt
- bir iddia
- kaynağı altta
<!-- konuşmacı notu -->
marp deste.md --pdf PDF üretir; VS Code eklentisi önizler ve dışa aktarır; bu sitedeki Marp çevrimiçi editör tarayıcıda çalışır, şablonlar ders ve konuşma için başlangıç desteleridir. Türkçe giriş: Marp nedir.
Editör seçenekleri
- VS Code: ücretsiz, Markdown önizlemesi yerleşik, Marp eklentisiyle slayt.
- Obsidian: not defteri olarak; Marp eklentileriyle slayt.
- Typora, iA Writer: yazarken biçimlendirilmiş gösteren editörler.
- Tarayıcı: bu sitenin editörü slayt için; not için herhangi bir çevrimiçi Markdown editörü.
- Lecture Studio: ders klasörünü Markdown dosyaları olarak tutar; desteler Marp, ders notları ve izlence Markdown; yardımcı kaynaklardan atıf vererek yazar (macOS 15+, Oberik proje anahtarı, beta süresince ücretsiz).
Sık sorulan sorular
Markdown nedir?
Düz metni #, **, - gibi işaretlerle biçimlendiren bir yazım biçimi; .md dosyaları her editörde açılır ve HTML, PDF, Word ya da slayta çevrilir.
Markdown dosyası nasıl açılır?
Herhangi bir metin editörüyle; VS Code, Obsidian ve Typora biçimlendirilmiş önizleme gösterir; GitHub tarayıcıda görüntüler.
Markdown'ı PDF'e nasıl çeviririm?
pandoc notlar.md -o notlar.pdf ile, ya da VS Code önizlemesinden yazdırarak. Slayt için marp deste.md --pdf ya da bu sitenin Markdown'dan PDF slayt aracı.
Markdown ile sunum hazırlanır mı?
Evet, Marp ile: marp: true ve --- ayırıcılarıyla yazılan Markdown, PDF, HTML ve PowerPoint'e çevrilir.