Ways of publishing a markdown knowledge base

This-knowledge-base exists as a obsidian vault on a local machine. It is an interesting question what is the best way to make it (or similar knowledge bases) available to the public.

1. Host it on Github

   • Like this page

   • pros

     • integrated markdown viewer

     • free

     • …

   • cons

     • Dependent on provider

     • Monopol

     • People only interested in vault contend get distracted by other functionality of github

2. Build Static web page and host it

   • Using Sphinx

     • Like this page

     • pros

       • standalone

       • configurable

       • open source (BSD)

     • cons

       • complicated to configure

       • No easy way to display file hirarchy

         • Could not configure table of content tree depth of sidebar in a nice way

         • Verry unintuitive to navigate

       • Not modern

       • Errors while building

   • Using Quarz

     • Like this page

     • pros

       • Modern look

       • Backlinks

       • Graph view

       • File explorer

       • open source (MIT)

     • cons

       • Integrates third party web content

         • gstatic.com

         • jsdeliver.net

         • plausible.io

       • No simple way to create static web page using command line

       • Complicated

       • GitHub Needed? Not sure

   • Jekyll

   • Pandoc