Uses the _notes directory as an Obsidian vault, with notes directly serving as the blog content source
obsidian-jekyll-blog — Jekyll Blog Template
By yaleiyale
A template that uses an Obsidian vault as the content source and builds a static blog with Jekyll, supporting backlink previews, graph view, tag and time navigation, with deployment options for Vercel and GitHub Pages.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 2
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Supports Obsidian backlink previews and graph view
Provides navigation by tags, time, and other means, with a customizable navigation structure
The README gives two deployment paths: Vercel and GitHub Actions + GitHub Pages
The theme uses a separate jekyll-theme-ObJekyll repository and can be replaced
A corresponding Hugo version repository is also available as an alternative
Template Details
obsidian-jekyll-blog is a blog template that combines Obsidian with Jekyll, which the author calls ObJekyll. It treats the _notes directory in the repository as an Obsidian vault, and the note content is built into a static site by Jekyll, so no local development environment is needed to publish. The template supports Obsidian-style backlink previews and graph view, and provides navigation by tags, time, and other means, with the navigation structure customizable through configuration. For publishing, the README gives two approaches: simple deployment on Vercel and deployment via GitHub Actions with GitHub Pages, and mentions that publishing can be completed with a single push.
The theme part uses a separate jekyll-theme-ObJekyll repository, which can be replaced. That theme template comes from wu-kan's jekyll-theme-WuK, and the Obsidian backlink-related implementation references maximevaillancourt's digital-garden-jekyll-template. The repository also has an open-sourced Hugo version, which the README says has faster local preview.
Limitations to note: the repository materials do not provide the Jekyll version, dependency list, or build environment requirements, so actual setup must be based on the repository files; the licensing of third-party assets such as demo images, fonts, and icons needs to be checked separately, and the MIT license only covers the code of this version itself; external services such as domains and hosting may incur costs.
Is it right for your project?
Use Cases
- Publishing an existing Obsidian vault as a public static blog
- A personal knowledge base site that needs to show connections between notes via backlinks and graph view
- A writing site hosted on GitHub Pages or Vercel and updated by push
- A Jekyll project that wants to adjust the appearance based on the ObJekyll theme or the WuK theme
Suitable For
- Individual users who take notes in Obsidian and want to publish them directly as a website
- Developers familiar with or willing to use Jekyll and GitHub Actions
- Bloggers who need note-style navigation structures such as backlinks, graph view, and tags
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
The repository does not provide a dependency list or Jekyll version information; check the repository files first to confirm environment requirements before setup
- 2
Place notes into the _notes directory to use it as an Obsidian vault
- 3
Deployment can be done via Vercel or GitHub Actions + GitHub Pages, configured according to the README instructions
- 4
The theme comes from jekyll-theme-ObJekyll and can be replaced or modified as needed
- 5
Third-party assets such as demo images, fonts, and icons need their licenses checked separately
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
https://github.com/yaleiyale/obsidian-jekyll-blog/blob/main/LICENSEhttps://github.com/yaleiyale/obsidian-jekyll-blog/blob/main/README.mdPermission is hereby granted, free of charge
Original License Text
Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- Partly documented · 68 / 100
- Technologies
- Jekyll
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2023-03-29
- Screenshot last checked
- 2026-10-02
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Jekyll as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: fff19398518b973513f52122ff10e4f8f50300d158564979e564c92ee8844567
2026-10-02T10:59:05.399Z
Source file / repository[hugo版本](https://github.com/yaleiyale/obsidian-hugo-blog)已开源,本地预览更迅速 # [罗盘在此 Click it](https://lestua.eu.org/notes/2022/08/29/223921)<br>开始使用 <!-- .slide --> # 无需担心 因为<br>无需开发环境 <!-- .slide vertical=true --> # 将_notes作为<br>Obsidian库 <!-- .slide --> # 支持双链<br>预览 和 图谱 <!-- .slide vertical=true --> # 标签,时间<br>更多自由定义<br>你的导航 <!-- .slide --> # 自定义配置<br>快速成型<br>一键push发布 <!-- .slide vertical=true --> # Vercel<br>简易部署 <!-- .slide --> # Github Actions<br> Pages部署 <!-- .slide vertical=true --> # 文本快速发布<br>你的在线博客 <!-- .slide -->  <!-- .slide vertical=true --> [默认主题](https://github.com/yaleiyale/jekyll-theme-ObJekyll)自定义替换,主题模板来自[wu-kan](https://github.com/wu-kan/jekyll-theme-WuK),<br>obsidian双链支持相关来自[maximevaillancourt](https://github.com/maximevaillancourt/digital-garden-jekyll-template)
Explore similar templates
Compare previews and descriptions within the same stack and category.

al-folio
A Jekyll academic homepage theme for scholars and researchers, with a clean responsive design and out-of-the-box support for publication lists, project showcases, CVs, and blogs.
Jekyll · Portfolio

minimal-mistakes
Minimal Mistakes is a two-column Jekyll theme for personal sites, blogs, project documentation, or portfolios.
Jekyll · Portfolio

Beautiful Jekyll
Beautiful Jekyll is a mature, easy-to-use Jekyll blog theme maintained by Dean Attali since 2015, with over 50,000 users.
Jekyll · Blog

jekyll-TeXt-theme
A customizable Jekyll theme for personal sites, team sites, blogs, projects, and documentation.
Jekyll · Blog

startbootstrap-clean-blog-jekyll
The official Jekyll version of Start Bootstrap's Clean Blog theme, offering a blog home page, about page, contact page, and sample post pages, with a Formspree-powered contact form.
Jekyll · Blog

So Simple
A minimal reading-oriented Jekyll theme by Michael Rose for personal blogs, portfolios, and long-form reading. It offers multiple layouts, microformat markup, Disqus comments, Google Analytics, Jekyll SEO Tag, three skins, and aggregation by year, category, and tag with a grid view.
Jekyll · Blog
