Obsidian od podstaw: edycja, linki i markdown

Problem

Obsidian po instalacji wygląda jak zwykły edytor tekstu — i tak go często traktujemy, tracąc 90% jego wartości. Cała siła narzędzia siedzi w kilku mechanizmach: linkach [[...]], embedach, paleta poleceń, backlinkach. Ten wpis to skondensowany przegląd składni i skrótów, których używasz każdego dnia, żeby przestać walczyć z edytorem i zacząć notować.

Pomijam instalację — zakładam, że masz otwarty vault i pustą notatkę.

Tworzenie i edycja

Nowa notatka: Ctrl/Cmd + N. Tworzy się w aktualnie otwartym folderze, więc najpierw kliknij katalog w panelu po lewej. Nazwa pliku = tytuł notatki. Obsidian zapisuje automatycznie — nie ma Ctrl+S.

Tryby edytora:

• Live Preview — formatowanie widać na bieżąco, ale nadal edytujesz źródło (domyślny)
• Source mode — czysty markdown bez upiększeń

Przełączasz przez paletę poleceń: Ctrl/Cmd + P → wpisz "toggle live preview".

Markdown — minimum, którego potrzebujesz

# Nagłówek 1
## Nagłówek 2
### Nagłówek 3

**pogrubienie**, *kursywa*, ~~przekreślenie~~, ==zakreślenie==

> Cytat blokowy.
> W wielu liniach.

---

Trzy myślniki --- w osobnej linii to pozioma kreska. Hierarchia nagłówków zasila panel "Outline" po prawej.

Listy

- punktowana
- z myślnikiem
  - zagnieżdżona (Tab albo dwie spacje)

1. numerowana
2. druga

- [ ] zadanie do zrobienia
- [x] zadanie zrobione

Enter w środku listy kontynuuje listę. Tab wcina element głębiej, Shift+Tab go wysuwa. Listy zadań - [ ] można później agregować w całym vaulcie wtyczkami typu Tasks albo Dataview.

Tabele

| Kolumna A | Kolumna B | Kolumna C |
|-----------|:---------:|----------:|
| lewy      | środek    | prawy     |
| dane      | dane      | dane      |

Dwukropki sterują wyrównaniem: :--- lewo, :---: środek, ---: prawo.

Linki wewnętrzne — serce Obsidiana

Tu zaczyna się prawdziwa różnica względem zwykłego edytora markdown:

[[Notatka]]                 zwykły link
[[Notatka|inny tekst]]      link z aliasem
[[Notatka#Nagłówek]]        link do konkretnej sekcji
[[Notatka#^abc123]]         link do konkretnego bloku
![[Notatka]]                embed — wstawia całą zawartość
![[Notatka#Nagłówek]]       embed pojedynczej sekcji
![[obrazek.png]]            embed obrazka
![[obrazek.png|400]]        embed z ograniczeniem szerokości do 400px

Gdy zaczniesz pisać [[, Obsidian podpowiada istniejące notatki. Jeśli wpiszesz nazwę nieistniejącej notatki, link jest tworzony "na zapas" — kliknięcie utworzy nową notatkę o tej nazwie.

Tagi

Notatka ze spotkania. #praca/klient-x #do-zrobienia

Ukośnik tworzy zagnieżdżenie (#praca/klient-x to podtag praca). Panel tagów po prawej pokazuje wszystkie tagi z liczbą wystąpień.

Wklejanie kodu

Inline — pojedyncze backticki:

Użyj funkcji `Array.map()` żeby przekształcić listę.

Bloki kodu — trzy backticki z nazwą języka dla podświetlania składni:

```javascript
function powitanie(imie) {
  return `Cześć, ${imie}!`;
}
```

```python
def powitanie(imie):
    return f"Cześć, {imie}!"
```

```bash
git checkout -b feature/nowa-funkcja
git push origin feature/nowa-funkcja
```

Obsidian rozpoznaje większość popularnych języków: js, ts, py, bash, sh, html, css, json, yaml, sql, rust, go, php, java, c, cpp.

Obrazki i załączniki

Przeciągnij plik z eksploratora do notatki albo wklej zrzut ekranu ze schowka (Ctrl/Cmd + V) — Obsidian skopiuje plik do vaulta i wstawi link.

Skróty, które warto znać od pierwszego dnia

Backlinki i graf

Panel "Backlinks" (po prawej) pokazuje wszystkie notatki, które linkują do aktualnie otwartej. Nie musisz tego ręcznie utrzymywać — Obsidian buduje powiązania w obie strony, gdy używasz [[...]].

Widok grafu (Ctrl/Cmd + G lub ikonka po lewej) renderuje całą sieć notatek wizualnie. Przy 5 notatkach to ciekawostka, przy 500 — realne narzędzie nawigacji.

Struktura na start

Nie próbuj zbudować perfekcyjnej hierarchii od razu. Trzy katalogi wystarczą na pierwszych kilka tygodni:

vault/
├── notatki/        codzienne myśli, fragmenty z lektur
├── projekty/       notatka per aktywny projekt
└── _attachments/   obrazki i pliki

Resztę organizujesz tagami i linkami. Gdy zauważysz, że ten sam typ notatek pojawia się często (notatki ze spotkań, recenzje książek), wyrzucasz je do osobnego folderu. Strukturę buduj reaktywnie, nie proaktywnie.

Co się dzieje pod spodem

Vault to zwykły folder z plikami .md i podfolderem .obsidian/ zawierającym konfigurację. Możesz go w każdej chwili otworzyć w VS Code, vimie albo zsynchronizować przez git — Obsidian nie trzyma niczego w bazie danych ani w chmurze (chyba że włączysz Obsidian Sync). Linki [[...]] to składnia wikilink, której pełny markdown formalnie nie obsługuje, ale Obsidian (i wiele innych edytorów typu Logseq, Foam) rozumie je natywnie. Backlinki są budowane on-the-fly przez parser Obsidiana przy każdej zmianie pliku — stąd ich aktualność bez konieczności jakiegokolwiek "rebuildu".