Obsidian Vault Integration

The Zer0-Mistakes repository is a fully-functional Obsidian vault. Open the repo root (or any subfolder containing notes) as a vault and every Markdown file is editable with Obsidian's wiki-links, embeds, callouts, graph view, and backlinks. The same files render on GitHub Pages with the equivalent presentation — no duplication, no separate sync step.

In this section

Page	What it covers
Getting started	Open the repo as a vault, recommended plugins, frontmatter rules.
Syntax reference	Every Obsidian feature and how it renders on the site.
Graph view	Interactive force-directed map of every page and wiki-link.
Authoring workflow	Daily note → commit → publish loop.
Troubleshooting	Broken links, missing embeds, conflicts.

How it works

The integration has two pieces:

1. Server-side data emission. A Liquid template emits assets/data/wiki-index.json at every Jekyll build, listing every collection document and standalone page (title, basename, permalink, tags, aliases, excerpt). This works on the default GitHub Pages remote_theme build with no custom plugins required.
2. Client-side resolver. assets/js/obsidian-wiki-links.js loads the index in the browser and rewrites [[wiki-links]], ![[embeds]], inline #tags, and Obsidian callout blockquotes into Bootstrap-styled HTML. The result is indistinguishable from server-rendered output for readers, and lets the integration ship on plain GH Pages without a custom CI workflow.

For users who self-build with vanilla Jekyll (no github-pages gem), an opt-in Ruby plugin (_plugins/obsidian_links.rb) performs the same transformations server-side for slightly better SEO. See the syntax reference for the complete feature matrix.

See also

• [[Getting Started with the Obsidian Vault]]
• [[Obsidian Syntax Reference]]
• [[Obsidian Graph View]]
• [[Obsidian Authoring Workflow]]
• [[Obsidian Integration Troubleshooting]]
• [[front-matter]]
• [[Installation]]