2

Rozdział 2 z 11

Instalacja Obsidiana i pierwszy vault

Opublikowany

Instalujemy Obsidiana, tworzymy vault jako zwykły folder w przemyślanym miejscu i piszemy pierwszą notatkę. Poznasz Markdown, linki między notatkami i najważniejsze skróty.

Czego się nauczysz

  • Instalacja ze strony lub przez Homebrew
  • Folder na vault i „Open folder as vault"
  • Pierwsza notatka i podstawy Markdown
  • Linki [[...]] i graf
  • Najważniejsze skróty

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)

  1. Wejdź na obsidian.md i kliknij Download.
  2. Otwórz pobrany plik .dmg.
  3. Przeciągnij ikonę Obsidian do folderu Applications.
  4. 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-obsidian i leży w ~/FactoryCode/, obok repozytoriów projektów. Nazwa jest dowolna; w przewodniku używamy moja-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
  1. Kliknij Open przy Open folder as vault.
  2. Wskaż folder moja-baza i kliknij Open.
  3. 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 📱

  1. Naciśnij ⌘ + N, żeby utworzyć nową notatkę.
  2. Pierwsza linia to tytuł; zostanie też nazwą pliku. Wpisz np. Pierwsza notatka.
  3. 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.

  1. W notatce wpisz [[ i zacznij pisać nazwę, np. [[Pomysły]].
  2. Jeśli notatka o tej nazwie istnieje, powstaje do niej link.
  3. 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-baza jest otwarty jako vault.
  • Utworzyłeś notatkę i widzisz plik .md w 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.

Narzędzia / paczki

Obsidian Homebrew Markdown

Spis treści