Project Alpha: Obsidian Jekyll Theme
Goal
Create a Jekyll theme that replicates the look and feel of the Obsidian note-taking app.
Status
🚧 In Progress
Features
Implemented
- Dark-first UI with light mode toggle
- 3-column layout (left sidebar, content, right sidebar)
- Wikilink support with
[[note-name]]syntax - Backlinks system
- Command palette search (
Ctrl/Cmd + K) - Auto-generated table of contents
- Obsidian-style callouts
- Tag system with
#hashtagsupport - Graph view with Vis.js
Planned
- Mermaid.js diagram support
- MathJax equation rendering
- Daily notes template
- Quick capture feature
- Plugin system
Technical Decisions
Note
This theme builds on patterns from just-the-docs but is a standalone implementation.
Why Jekyll?
- Static site generation for fast, reliable hosting
- Liquid templating for dynamic content
- Ruby plugins for build-time processing
- GitHub Pages compatible (with limitations)
Why Vis.js for Graph View?
- Lightweight and performant
- Built-in physics simulation
- Interactive zoom/pan/click
- Simple API
Why Fuse.js for Search?
- Client-side fuzzy matching
- No server required
- Fast and lightweight
- Good UX with instant results
Related Notes
- Zettelkasten — Knowledge management method powering this vault
- Evergreen Notes — Note-taking philosophy
- Getting Started — User guide
- Markdown Features — Formatting reference
Timeline
| Date | Milestone |
|---|---|
| 2026-03-23 | Project started |
| 2026-03-23 | Core layout complete |
| 2026-03-23 | Wikilinks + backlinks working |
| TBD | First release |