Rozdział 2: Instalacja Obsidiana i pierwszy vault
Instalujemy Obsidiana, tworzymy folder na bazę wiedzy (vault) i piszemy pierwszą notatkę. Po drodze poznasz trzy rzeczy, których używa się codziennie: Markdown, linki [[...]] i kilka skrótów klawiszowych.
Po tym rozdziale masz zainstalowanego Obsidiana, pusty vault i umiesz pisać notatki połączone linkami.
Krok 1 — Instalacja 💻
Masz dwie drogi. Wybierz jedną.
Opcja A: ze strony (najprostsza)
- Wejdź na obsidian.md i kliknij Download.
- Otwórz pobrany plik
.dmg. - Przeciągnij ikonę Obsidian do folderu Applications.
- Uruchom Obsidiana z Launchpada albo przez Spotlight (⌘ + Spacja, wpisz „Obsidian”).
Opcja B: przez Homebrew
Jeśli masz Homebrew, wystarczy jedna komenda w terminalu:
brew install --cask obsidian
Obsidian jest darmowy i nie wymaga zakładania konta.
Krok 2 — Utwórz folder na bazę wiedzy 💻
Vault to zwykły katalog. Warto od razu wybrać dla niego stałe, sensowne miejsce, bo w Rozdziale 7 zrobimy z niego repozytorium Git.
Dobra praktyka: trzymaj vault obok swoich projektów, a nie w iCloud. Synchronizacją zajmie się Git (Rozdział 8), a dwa systemy synchronizacji naraz potrafią się kłócić.
mkdir -p ~/Projekty/moja-baza
W naszym przykładzie vault nazywa się
factorycode-obsidiani leży w~/FactoryCode/, obok repozytoriów projektów. Nazwa jest dowolna; w przewodniku używamymoja-baza.
Krok 3 — Otwórz folder jako vault 📱
Po pierwszym uruchomieniu Obsidian pokazuje ekran startowy z kilkoma opcjami:
| Opcja | Kiedy jej użyć |
|---|---|
| Quick start | szybki start z przykładowym vaultem; nie używamy |
| Create new vault | Obsidian sam tworzy nowy folder |
| Open folder as vault | otwierasz istniejący folder; tego używamy |
| Open vault from Obsidian Sync | płatna synchronizacja Obsidiana; nie używamy |
- Kliknij Open przy Open folder as vault.
- Wskaż folder
moja-bazai kliknij Open. - Jeśli Obsidian zapyta, czy ufasz autorowi vaulta, kliknij Trust author. To Twój własny folder.
Oczekiwany rezultat: widzisz okno Obsidiana z pustym panelem plików po lewej.
Dlaczego „Open folder”, a nie „Create”? Obie opcje dają to samo, ale gdy folder tworzysz sam (krok 2), dokładnie wiesz, gdzie leży. To ważne przy Gicie i przy agencie AI.
Krok 4 — Pierwsza notatka 📱
- Naciśnij ⌘ + N, żeby utworzyć nową notatkę.
- Pierwsza linia to tytuł; zostanie też nazwą pliku. Wpisz np.
Pierwsza notatka. - Pod spodem pisz normalny tekst.
Notatka od razu zapisuje się na dysku jako plik Pierwsza notatka.md. Nie ma przycisku „Zapisz”, bo nie jest potrzebny.
Podstawy Markdown
Markdown to prosty sposób formatowania tekstu znakami:
# Duży nagłówek
## Mniejszy nagłówek
**pogrubienie**, *kursywa*
- lista punktowana
- kolejny punkt
- [ ] zadanie do odhaczenia
- [x] zadanie zrobione
`krótki kod` i link: [obsidian.md](https://obsidian.md)
⌘ + E przełącza między edycją a podglądem, więc zobaczysz efekt.
Krok 5 — Linki między notatkami 📱
To najważniejsza funkcja Obsidiana.
- W notatce wpisz
[[i zacznij pisać nazwę, np.[[Pomysły]]. - Jeśli notatka o tej nazwie istnieje, powstaje do niej link.
- Jeśli nie istnieje, link jest „pusty”. Kliknięcie w niego tworzy nową notatkę.
Możesz też zmienić tekst linku: [[Pomysły|moje pomysły]] pokaże „moje pomysły”, a poprowadzi do notatki „Pomysły”.
Linki widać w grafie (⌘ + G albo ikona grafu w lewym pasku). Na razie to dwie kropki, ale z czasem graf staje się mapą Twojej wiedzy.
Skróty, które warto znać od razu
| Skrót | Co robi |
|---|---|
| ⌘ + N | nowa notatka |
| ⌘ + O | szybkie otwieranie notatki po nazwie |
| ⌘ + P | paleta komend (wszystkie funkcje w jednym miejscu) |
| ⌘ + E | edycja / podgląd |
| ⌘ + Shift + F | szukanie we wszystkich notatkach |
| ⌘ + G | graf powiązań |
| ⌘ + , | ustawienia |
Najczęstszy błąd początkujących: godziny spędzone na wtyczkach i motywach zamiast na pisaniu. Na start nie instaluj niczego dodatkowego. Jedyną wtyczką w tym przewodniku będzie Git (Rozdział 8).
Weryfikacja rozdziału
- Obsidian jest zainstalowany i się uruchamia.
- Folder
moja-bazajest otwarty jako vault. - Utworzyłeś notatkę i widzisz plik
.mdw Finderze, w folderze vaulta. - Umiesz zrobić link
[[...]]i zobaczyć go w grafie.
Podsumowanie
- ✅ Zainstalowałeś Obsidiana (ze strony lub przez Homebrew).
- ✅ Utworzyłeś vault jako zwykły folder w przemyślanym miejscu.
- ✅ Znasz podstawy Markdown, linki
[[...]]i najważniejsze skróty.
Po tym rozdziale masz działający, pusty vault. W następnym rozdziale nadamy mu strukturę: foldery, konwencje i ustawienia, które przydadzą się, gdy dołączy agent AI.
Dalej: Rozdział 3 — Struktura folderów i konwencje.