Files
guide/06-markdown-basics

🇬🇧 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

# Title
## Section
### Subsection

Leave a blank line before and after a heading.

Text

**bold**  *italic*  ~~struck through~~  `code`

A single line break is ignored. To start a new paragraph, leave a blank line.

Lists

- first
- second
  - nested (two spaces)

1. step one
2. step two
[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:

```bash
git status
```

Tables

| Column | Meaning |
|--------|---------|
| `main` | default branch |
| `.md`  | Markdown file |

Quotes, rules, tasks

> 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

# Başlık
## Bölüm
### Alt bölüm

Başlığın öncesinde ve sonrasında boş satır bırakın.

Metin

**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

- birinci
- ikinci
  - iç madde (iki boşluk)

1. birinci adım
2. ikinci adım

Bağlantılar

[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:

```bash
git status
```

Tablolar

| Sütun  | Anlamı |
|--------|--------|
| `main` | varsayılan dal |
| `.md`  | Markdown dosyası |

Alıntı, çizgi, görev listesi

> 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: 📌 ✅ ⚠️