tov-jukov / oth

oth (Obsidian To HTML)

This is a template for publishing obsidian notes as a static site. The goal of the project is to stay minimal, but have enough features to showcase how you do things in the unified ecosystem.

⚠️ Wikilinks to subdirs must be [[subdir/note]] NOT [[note]] as obsidian does by default. Change obsidian's "New link format" in Files & Links to "Relative path to file" to avoid issues. (Or better: use flat files like god intended)

Features

See here for a demo

• Works without client side javascript
• Code highlighting
• Math support
• [[wikilinks]] support
• Runs js code in ```js run blocks and splices in the exported markdown

Setup

1. Create a repo using the template
2. Go to Settings -> Pages and set "deploy branch" to gh-pages and path to be the root /
3. Profit