# ripgrep (`rg`) – Quickstart Guide

> [!info] Was ist ripgrep?
> `ripgrep` ist ein extrem schnelles, zeilenorientiertes Suchwerkzeug, das rekursiv Verzeichnisse nach Regex-Mustern durchsucht. Es respektiert standardmäßig `.gitignore` Dateien.

## 1. Basis-Befehle
| Befehl | Beschreibung |
| :--- | :--- |
| `rg "Suchbegriff"` | Sucht rekursiv im aktuellen Verzeichnis. |
| `rg "Suchbegriff" Pfad/zu/Ordner` | Sucht in einem spezifischen Verzeichnis. |
| `rg -i "suchbegriff"` | Ignoriert Groß-/Kleinschreibung (*ignore case*). |
| `rg -w "wort"` | Sucht nur nach ganzen Wörtern (*whole word*). |
| `rg -v "begriff"` | Invertierte Suche (zeigt Zeilen, die den Begriff **nicht** enthalten). |

## 2. Dateitypen filtern
Ripgrep kann Suchen auf bestimmte Dateitypen einschränken:
- `rg -t md "Suchbegriff"`: Nur in **Markdown**-Dateien suchen.
- `rg -T html "Suchbegriff"`: **HTML**-Dateien ausschließen.
- `rg --type-list`: Zeigt alle verfügbaren Dateitypen an.

## 3. Kontext-Optionen
Hilfreich, um die Zeilen um den Treffer herum zu sehen:
- `rg -A 3 "Begriff"`: Zeigt 3 Zeilen **nach** (*After*) dem Treffer.
- `rg -B 3 "Begriff"`: Zeigt 3 Zeilen **vor** (*Before*) dem Treffer.
- `rg -C 3 "Begriff"`: Zeigt 3 Zeilen **Kontext** (davor und danach).

## 4. Fortgeschrittene Suche
- `rg -l "Suchbegriff"`: Gibt nur die **Dateinamen** der Treffer aus.
- `rg -n "Suchbegriff"`: Zeigt die **Zeilennummern** an (Standard).
- `rg -u`: Ignoriert `.gitignore` (unrestricted). Nutzen Sie `-uu` für versteckte Dateien und `-uuu` für Binärdateien.
- `rg -e "Muster1" -e "Muster2"`: Suche nach mehreren Mustern (ODER-Verknüpfung).

## 5. Suchen und Ersetzen (Trockenübung)
`ripgrep` selbst ersetzt keine Dateien, kann aber das Ergebnis für Tools wie `sed` vorbereiten:
- `rg "alt" --replace "neu"`: Zeigt in der Konsole an, wie die Ersetzung aussehen würde, ohne die Datei zu ändern.

## 6. Tipps für Obsidian-Nutzer
Falls du `ripgrep` in deinem Vault nutzt:
- **Tags finden:** `rg "#projekt/aktiv"`
- **Interne Links:** `rg "\[\[Notizname\]\]"`
- **Unfertige Aufgaben:** `rg "- \[ \]" -t md`

---
*Erstellt am: 06.05.2026*