kılavuz: KabaForge kullanım kılavuzu (EN + TR, 10 bölüm)

06-markdown-basics/readme.md

@@ -0,0 +1,157 @@
+# 🇬🇧 06 — Markdown basics
+
+Markdown is plain text with a few punctuation rules. Files ending in `.md` are rendered automatically, and a file named `readme.md` is shown on its folder page.
+
+## Headings
+
+```markdown
+# Title
+## Section
+### Subsection
+```
+
+Leave a blank line before and after a heading.
+
+## Text
+
+```markdown
+**bold**  *italic*  ~~struck through~~  `code`
+```
+
+A single line break is ignored. To start a new paragraph, leave a blank line.
+
+## Lists
+
+```markdown
+- first
+- second
+  - nested (two spaces)
+
+1. step one
+2. step two
+```
+
+## Links
+
+```markdown
+[KabaForge](https://forge.kabaforce.com)
+[chapter 04](../04-create-directory/readme.md)
+```
+
+Links to files in the same repository are best written as relative paths — they keep working on every branch.
+
+## Code
+
+Fenced blocks keep spacing and add colours. Write the language after the opening fence:
+
+~~~markdown
+```bash
+git status
+```
+~~~
+
+## Tables
+
+```markdown
+| Column | Meaning |
+|--------|---------|
+| `main` | default branch |
+| `.md`  | Markdown file |
+```
+
+## Quotes, rules, tasks
+
+```markdown
+> A quoted note.
+
+---
+
+- [x] done
+- [ ] not done yet
+```
+
+## Practical tips
+
+- Preview before committing: the **Preview** tab in the editor renders exactly what others will see.
+- Keep one sentence per line in long documents — differences between versions stay readable.
+- Emoji work directly: 📌 ✅ ⚠️
+
+---
+
+# 🇹🇷 06 — Markdown temelleri
+
+Markdown, birkaç noktalama kuralı olan düz metindir. `.md` ile biten dosyalar otomatik olarak biçimlendirilir; `readme.md` adlı dosya bulunduğu klasörün sayfasında gösterilir.
+
+## Başlıklar
+
+```markdown
+# Başlık
+## Bölüm
+### Alt bölüm
+```
+
+Başlığın öncesinde ve sonrasında boş satır bırakın.
+
+## Metin
+
+```markdown
+**kalın**  *italik*  ~~üstü çizili~~  `kod`
+```
+
+Tek satır sonu yok sayılır. Yeni paragraf için boş satır bırakın.
+
+## Listeler
+
+```markdown
+- birinci
+- ikinci
+  - iç madde (iki boşluk)
+
+1. birinci adım
+2. ikinci adım
+```
+
+## Bağlantılar
+
+```markdown
+[KabaForge](https://forge.kabaforce.com)
+[bölüm 04](../04-create-directory/readme.md)
+```
+
+Aynı depodaki dosyalara göreli yolla bağlanmak en iyisidir — her dalda çalışmaya devam eder.
+
+## Kod
+
+Çitli bloklar boşlukları korur ve renk verir. Açılış çitinden sonra dili yazın:
+
+~~~markdown
+```bash
+git status
+```
+~~~
+
+## Tablolar
+
+```markdown
+| Sütun  | Anlamı |
+|--------|--------|
+| `main` | varsayılan dal |
+| `.md`  | Markdown dosyası |
+```
+
+## Alıntı, çizgi, görev listesi
+
+```markdown
+> Alıntılanmış not.
+
+---
+
+- [x] bitti
+- [ ] henüz bitmedi
+```
+
+## Pratik ipuçları
+
+- İşlemeden önce önizleyin: editördeki **Önizleme** sekmesi, başkalarının göreceğinin aynısını gösterir.
+- Uzun belgelerde her cümleyi ayrı satıra yazın — sürümler arası farklar okunaklı kalır.
+- Emoji doğrudan çalışır: 📌 ✅ ⚠️