# 06 — Markdown basics

🌍 **English** · [Türkçe](../../tr/06-markdown-basics/readme.md) · [Deutsch](../../de/06-markdown-basics/readme.md) · [Français](../../fr/06-markdown-basics/readme.md) · [Русский](../../ru/06-markdown-basics/readme.md)

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

---

⬅ [Previous: 05 — Deleting files and directories](../05-delete-files/readme.md) · 📚 [Contents](../README.md) · [Next: 07 — Images and attachments](../07-images-and-media/readme.md) ➡