Az Obsidian jegyzeteidből egy böngészőben futó, statikus weboldalt generálhatsz a Baselinks nevű eszközzel, teljesen ingyen, szerver nélkül, és a fájljaid sosem hagyják el a gépedet. Nincs telepítés, nincs regisztráció – bedobod a vault mappádat, és kapsz egy ZIP-et a kész oldallal.
Az r/ObsidianMD subredditen bogarásztam a napokban, és belefutottam ebbe a projektbe. Haidar Alfarizy csinálta, a forráskód fent van a GitHubon, maga az eszköz pedig egy sima webalkalmazás, amit a böngésződben nyitsz meg. Gondoltam, megosztom veletek is, mert tényleg hasznos kis cucc, főleg ha valaki gyorsan szeretné a jegyzeteit publikálható formába önteni.
Tartalomjegyzék
Miért érdekes ez egyáltalán?
Ha Obsidiant használsz, előbb-utóbb felmerül a kérdés: hogyan lehetne a jegyzeteimből valami olyat csinálni, amit meg tudok mutatni másoknak? Mondjuk egy kollégának, egy ügyfélnek, vagy egyszerűen csak nyilvánosan megosztani, mint egy wiki-szerű tudásbázist.
Az Obsidiannek van hivatalos megoldása erre, az Obsidian Publish. Ez egy kimondottan jópofa szolgáltatás, hover preview-val, graph view-val, stackelt oldalakkal, backlink listával – gyakorlatilag az Obsidian élményt viszi ki a webre. Az ára havi 8 dollár (éves számlázás esetén), havi fizetéssel 10 dollár. Ez nem vészes összeg, de ha csak alkalmanként kellene publikálni, vagy egyszerűen nem akarsz havonta fizetni egy szolgáltatásért, akkor már gondolkodsz az alternatívákon.
Na és itt jön a probléma: az alternatívák többsége nem éppen egyszerű. A Quartz például remek és ingyenes, de telepítened kell Node.js-t, konfigurálni kell, GitHub repót kezelni, buildelni. A Hugo-val való megoldáshoz még több technikai tudás kell (pre-commit hook-ok, obsidian-export, frontmatter kezelés). Az ObsidianHtml, a Lettersmith, a Pubsidian – mind működőképes projektek, de mindegyikhez értened kell valamennyit a parancssorhoz, a statikus generátorokhoz, vagy a deployment-hez.
Szóval nincs túl sok olyan opció, ami tényleg egyszerű lenne. Ahol nem kell semmit telepíteni, és nem kell fejlesztői háttértudás.
Így működik a Baselinks
A Baselinks ezen a ponton üdítő kivétel . Megnyitod a böngészőben, ráhúzod (vagy kiválasztod) a vault mappádat, és kapsz egy letölthető ZIP fájlt, ami tartalmazza a statikus weboldaladat. Ennyi. A projekt forráskódja letölthető itt: https://github.com/haidaralfarizy/baselinks
Két üzemmódja van: Export és Analyze. Az Export az, ami a lényeg – ez gyártja le a HTML oldalakat a Markdown fájljaidból. Az Analyze a vault struktúráját elemzi, ami szintén hasznos lehet, ha kíváncsi vagy a jegyzeteid közötti kapcsolatokra, de a fő funkció egyértelműen az exportálás.
Ami fontos: minden a böngésződben történik, lokálisan. A fájljaid nem mennek sehová, nem töltődnek fel semmilyen szerverre. Ez privacy szempontból kifejezetten jó megoldás, és ezt a fejlesztő is hangsúlyozza.
Kipróbáltam – villámgyors és működik
Ráengedtem a saját vault-om egy részét, és őszintén meglepett, milyen gyorsan végzett. Szó szerint pár másodperc, és megvolt a ZIP. Kicsomagoltam, megnyitottam a böngészőben, és egy tiszta, olvasható, wiki-szerű weboldal nézett vissza rám.
A generált oldal letisztult, navigálható, és a mappastruktúrát is megtartja. Ha valakinek gyorsan kell egy bemutatható verzió a jegyzeteiből – mondjuk egy tudásbázist akar összerakni és megosztani a csapatával –, ez tökéletesen megoldja.
Van azért egy korlátja
Ami nálam nem működött tökéletesen: a jegyzetek közötti kereszthivatkozások ([[Másik jegyzet]] stílusú Obsidian wikilink-ek). A Baselinks felismerte ezeket a linkeket, jelölte is őket linkként az exportált oldalon, de a tényleges hivatkozást (vagyis hogy hová mutasson a link) nem generálta le mindig helyesen. Szóval a wikilink-ek megjelennek, de kattintásra nem feltétlenül visznek oda, ahová kellene.
Ez kicsit bosszantó, de végül is nem tragédia. Két megoldás is van rá: vagy utólag, kézzel szerkeszted a pár hibás linket az exportált HTML-ben, vagy – és ez a szép a nyílt forráskódú projektekben – letöltöd a kódot a GitHubról és kiegészíted azt a részt, ami a wikilink-eket konvertálja. A projekt nem bonyolult, JavaScript alapú, és a forráskód áttekinthető. Ha valaki ért hozzá, nem egy nagy projekt megoldani.
Kinek és mire jó?
A Baselinks nem az Obsidian Publish versenytársa – nem is akar az lenni. Nincs benne graph view, hover preview, egyedi domain beállítás, vagy automatikus szinkronizálás. Viszont ha az a kérdés, hogy „hogyan csinálok a jegyzeteimből gyorsan egy megosztható weboldalt, nulláról, ingyen, telepítés nélkül” – erre ez az egyik legegyszerűbb válasz, amit eddig láttam.
Különösen hasznos lehet, ha dokumentációt akarsz gyorsan megosztani egy kis csapattal, belső tudásbázist akarsz publikálni intranetben, vagy éppen prezentálnod kell a jegyzeteidet valamilyen formában. Feltöltöd a ZIP tartalmát bármilyen statikus tárhelyre (GitHub Pages, Netlify, Cloudflare Pages, vagy egy sima webszerver), és kész.
Aki viszont komolyabb, hosszú távú publikálási megoldást keres az Obsidian vault-jához, annak érdemes megnézni a Quartz-ot (ingyenes, nyílt forráskódú, de több beállítást igényel), a Flowershow-t (szintén ingyenes alaptervvel), vagy ha nincs kedve bütykölni, az Obsidian Publish a havi 8 dollárjával valóban kényelmes megoldás.
GYIK
A Baselinks biztonságos? A jegyzeteim nem kerülnek fel valahová?
Igen, biztonságos. Az egész konverzió a böngésződben történik, lokálisan. A fájljaid nem hagyják el a gépedet, nem töltődnek fel semmilyen szerverre.
Kell hozzá telepíteni valamit?
Nem. Megnyitod a böngészőben a Baselinks weboldalát, és ennyi. Nincs szükség Node.js-re, Python-ra, Git-re, vagy bármi másra.
Működik a Dataview, a Templater vagy más Obsidian plugin tartalom az exportban?
Nem, a Baselinks a nyers Markdown fájlokat dolgozza fel. Ha egy jegyzetben Dataview lekérdezés vagy Templater kód van, az nem fog renderelődni – a nyers szintaxis jelenik meg helyette. Ez egyébként a legtöbb alternatív megoldásra is igaz.
Lehet egyedi CSS-t használni az exportált oldalon?
Mivel a kimenet sima HTML + CSS, utólag bármit tudsz rajta módosítani. A generált ZIP-ben ott vannak a stílusfájlok, amiket kedved szerint szerkeszthetsz.
Mennyire aktív a projekt fejlesztése?
A GitHub repóban egyelőre egyetlen commit van. Ez egy viszonylag friss projekt, szóval érdemes figyelni a fejlesztését, de ne számíts rá, hogy hetente jönnek az új feature-ök.
Szójegyzék
- Vault – Az Obsidianban a jegyzeteidet tartalmazó mappa, ami az összes .md fájlt és almappát fogja össze.
- Static site generator (SSG) – Olyan eszköz, ami forrásfájlokból (pl. Markdown) előre legenerált HTML oldalakat készít, amiket aztán bármilyen egyszerű webszerveren hosztolhatsz.
- Wikilink – Az Obsidian saját belső hivatkozási formátuma:
[[Jegyzet neve]]. Más Markdown szerkesztők nem ismerik fel, ezért exportálásnál konvertálni kell. - Digital garden – A személyes tudásbázis nyilvánosan megosztott változata, ahol a jegyzetek összekapcsolódnak, és folyamatosan fejlődnek – szemben egy hagyományos blog kronologikus struktúrájával.
