obsidian-github-publisher VS mdBook

Obsidian GitHub Publisher (the plugin)

400€ per year on a personal blog? To each their own, I guess.

I host my blogs on GH pages or Netlify. Additionally, I dump the notes I want to share with the world on GH pages as well with the excellent Obsidian Github Publisher [0] Plugin. I don't really care about analytics for a personal blog though.

Works for me, and costs nothing.

[0]: https://github.com/ObsidianPublisher/obsidian-github-publish...

MkDocs with Obsidian Mkdocs? https://obsidian-publisher.netlify.app

Love it! I've played with hugo blogging 6 years ago and liked it, but hated picking a template and didn't want to learn go to figure out how to customize things. I saw a different MkDocs obsidian plugin: https://obsidian-publisher.netlify.app/

Here is the documentation page of the plugin, which also serves as a demo of a published vault using this plugin https://obsidian-publisher.netlify.app

This plugin will handle all of this for you: https://github.com/ObsidianPublisher/obsidian-github-publisher

I'm responsible for a number of Java products. I try to provide high-quality Javadoc for all public library interfaces, library user's guides where appropriate, and development guides for applications. The latter two take the form of MDBook documents (https://rust-lang.github.io/mdBook/), with the document source living in the GitHub repo so that it's tied to the particular software release in a natural way.

My org has used mdBook: https://rust-lang.github.io/mdBook/ (That link is itself a rendered mdBook, so that'll give you an idea of the feature set.)

(While it's definitely a Rust "thing", if you just have a set of .md files, all you need is a "SUMMARY.md" (which contains the ToC) and a small config file; i.e., you don't have to have any Rust code to use it, and it works fine without. We document a large, mostly non-Rust codebase with it.)

If you want the lowest friction, open source, easily extensible Markdown to Web, Kindle, PDF, etc. tool, highly recommend mdBook: https://github.com/rust-lang/mdBook it’s written in Rust, but you don’t have to know any Rust to use it. And then wing is all CSS; for which there are many good (free) themes.