Wanna publish your notes, but don't want to mess around with configs and such? This repo is here for that, fork it, add your notes, commit, push and you are published.
- Fork this repo
- There's an Obsidian vault under
notes
folder here. You can adapt it as your own and push - A github action and a hacky
build.py
script will turn the vault into a GithubPages website for the notes - It supports: latex,code highlighting, images, Disqus discussions and appends backlinks to the end of the page
- Navigation bar - get generated from top level markdown page under
notes
folder - Notes - Pages in all other subfolders of
notes
are turned into notes pages - All Notes - page is autogenerated and added to nav-bar
You can set 3 (optional) properties to pages in the frontmatter
- title - the title of the page to be displayed (if not set file name is used)
- date - date of page (used for sorting all post from new to old). if not set, file creation date is used
- disqus - name for a disqus website to be embedded at the end of the page (nothing happens if not set)
- Set default subfolder for the notes, all top level pages under
notes
will get turned into nav-bar items, so maybe . - Make sure that Obsidian keeps links in markdown format and absolute path in vault(this is already set in the default vault)
- Never tested but probably works with other markdown editors Script only assumes markdown files and dollar sign for inline latex and double dollar sign for block latex.
- Disqus - you can add a Disqus threads to notes by specifying frontmatter fields
disqus
and set fields value to the name of your disqus site