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 #hashtag support
  • 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
  • Client-side fuzzy matching
  • No server required
  • Fast and lightweight
  • Good UX with instant results

Timeline

Date Milestone
2026-03-23 Project started
2026-03-23 Core layout complete
2026-03-23 Wikilinks + backlinks working
TBD First release
Graph View
Tags
Folders
Options