"Obsidian+Github Pages" for digital gardeners?

You could use plugins for converting links in some static site generators like
Gatsby (https://github.com/aravindballa/gatsby-theme-andy) or Jekyll (Simply Jekyll Theme) https://simply-jekyll.netlify.app/posts/introduction-to-simply-jekyll

Here you could find even more resources https://github.com/MaggieAppleton/digital-gardeners


Thanks - still, its an extra step

@ShaneRobinson Excuse the direct ping, but you seem pretty knowledgeable about this… would you mind looking at my question here: Understanding digital garden creation with Obsidian

Many thanks!

1 Like

Foam discusses the issues directly, which affect them more because of the Github linkage. Has found no solution, but switched from md to wiki syntax because of the superior ergonomics.

I created a template, eleventy-garden, with Obsidian in mind. It does work with wiki-style links (ie. [[filename]]).

The only hitch I see is the GitHub piece. Would the user create an account & repo themselves? Once you’re doing that, why not just push to GitHub yourself?


It would be great if a vault or a part of the vault could be easily published on the web. This could potentially be very simple through e.g. GitHub Pages, which has templating mechanisms that turn markdown into HTML (https://pages.github.com/).

Unfortunately, my first test of doing this with the current markdown generated by Obsidian failed:

resulted in

The link is broken and the image is not shown. I assume this is because of a mismatch in markdown syntax between Obsidian and GitHub pages; also GitHub pages cannot know the Obsidian setting for the folder in which file attachments are located.

It would be great to have a tutorial, export script or other helpful material for turning Obsidian content into web pages!


This is a planned feature and well advertized in the homepage as part of the services that will be offered!


Oops. Okay, eagerly waiting for the release that will introduce that feature! :slight_smile:

1 Like

Yes! They announced this “publishing mode” was going to be a feature time ago, but still haven’t heard anything about it.
So, I also tried to share my notes on the web (as a public blog). But did fail, too :frowning:
Hope Obsidian have this as a high priority on their roadmap, so we can publish online directly with Obsidian and forget about exporting every note and reformatting to a time-consuming blogging platform.

This one is a high priority for me too! I would also like

  1. to know the licensing implications of this, if I use this feature for example to generate documentation for my business but technically obsidian itself is not used by the business?

  2. to just export the markdown files as is, except replacing all [[page links]] with relative urls at time of export (so that it can be ingested by jekyll or the like)

  3. to know where i can follow the roadmap of this feature more closely (beyond the “long-term” ticket item existing in the trello board)

  4. to be able to contribute to this plugin, static site content generation from markdown files is something i have many opinions about :slight_smile:


I spent 4 hours trying to figure this out on my own today using Hexo, Hugo, Harp, and Ghost, with no success.

I don’t need a full-fledged document management system, I just want to publish my notes to Github pages (or a lightweight, minimalist static site generator) so others can browse it.

Is the full “Publishing” feature going to be only github pages or have multiple publishing options?


Possible few solutions are:

  1. https://github.com/mathieudutour/gatsby-digital-garden (Built on Gatsby)
  2. https://github.com/raghuveerdotnet/simply-jekyll (Built on Hugo)
  3. https://github.com/aengusmcmillin/gatsby-theme-brain (Built on Gatsby)

In all three, you commit your changes to Github and then let Netlify take a build and publish your content.

All of these generate backlinks when you publish. However, none of the above solutions were built keeping Obsidian in mind.

  • Gatsby Digital Garden was built to import and publish content from Roam. It also has a graph view. It displays transcluded text in backlinks when content is imported from Roam but not when content is authored elsewhere in markdown.

  • Simply Jekyll uses [[ ]] for wiki like links, and therefore can be used for publishing content authored in Obsidian. However, it also uses [[ ]] for many of its other nifty functionalities. So, you have to either let go of those functionalities or stop using Obsidian as the text editor. VS Code with Notecomplete plugin works. It is also the only one that has search built in. Check out https://www.raghuveer.net, personal blog site of the author of Simply Jekyll.

  • Gatsby Theme Brain does not provide either a graph view or even a list of topic. Also, it picks up topic title from the YAML frontmatter.

  • None of these currently support [[Actual Topic Title|Desired Display Text]] or [[Topic Title#Heading]] links. And I am not sure if any of these can be used to selectively publish topics.


I just discovered a Git-based wiki static site generator, which seems to support [[]] links https://github.com/gollum/gollum/wiki#link-tag, an RSS feed of changes to the wiki https://github.com/gollum/gollum/wiki/5.0-release-notes#rss-feed, and many more features. I wonder if folks hosting their Obsidian vault in Git would be able to use this alongside it for an easy automatic publishing solution. The RSS feed is of particular interest to me because it means I could also make a newsletter out of it. Anyone more technical than me know if there’s a reason this wouldn’t work?


Hey there,

I built a solution for publishing Obsidian notes to GitHub Pages and other platforms.

With docsify I create a single page application and then added a docsify plugin to convert the wiki links.

In short I walked through regex hell to convert wiki links.

Next step is SSR.


I have another and simple solution here, using mkdocs(github page) and my mkdocs roamlike plugin, see: https://github.com/Jackiexiao/foam-mkdocs-template

it support [[roamlink]], add it could automatically publish to github page



You can use this fork of simply-jekyll to get access to [[]] (internal and external) links :

I use it with Obsidian everyday and it works very well : https://arboretum.link

I’m not sure it integrates well with GitHub pages, but you can host it at Netlify for free and as easily as GitHub Pages.

If you want the [[]] feature for your site, you can check the content.html file in _includes\ which contains this functionality.


Since I use pelican as a static site generator I built a small plugin for that. GitHub - jonathan-s/pelican-obsidian: Makes it possible to bridge work in obsidian to pelican seamlessly

This is not exact solution to your query, but look forward to this potential solution:

I recently found Publii. It is an offline CMS (static site generator). But currently don’t support any of the Obsidian features (except markdown input). However, they say they are going to allow extending it through ‘Plugins’.

Hope, it will help us publish Obsidian Vaults through it. Btw, I raised an issue for this specific enhancement on their Github profile. It would be nice if more persons, encourage them to bring such plugin.

Unfortunately, GitHub Pages still only use the same old list of plugins that are allowed, and any plugins (like simply-jekyll) are disabled for GH Pages.

Netlify is definitely the go-to option I hear from people who want to use Obsidian for publishing.

1 Like

Here is a template to publish Obsidian notes using the Python documentation library MkDocs

1 Like