Obsidian + Docusaurus = Where your Obsidian notes meet the web
Warning
Obsidiosaurus is no longer actively maintained.
I am no longer using this project myself, so I will not be developing it further.
A community-maintained fork is available here: https://github.com/KenBlasse/obsidiosaurus
The fork includes:
- Docusaurus v3 support
- GraphicsMagick replaced with the Canvas API
- no native dependencies
- TypeScript 5.4
- fixes for asset paths, ENOENT issues, and orphaned files on rename
Thanks to KenBlasse for continuing the project.
Obsidiosaurus is a converter for Obsidian markdown notes to the static site builder Docusaurus
It allows for a better experience writing and maintaining the markdown files, since both share a lot of common features.
You find detailed instructions on how to use and setup in the official Documentation Website made with Docusaurus and Obsidian using Obsidiosaurus, interested to see the Docs repo? Check here
Overview about what is currently supported:
- Documentation: ✅
- Blog: ✅
- Multiple Blogs: ✅
- Localisation i18n: ✅
- Multiple Sidebars: ✅
- Versioning: ⛔ (kinda complex)
- Links: ✅
- Tables: ✅
- Admoninitions: ✅
- Quotes: ✅
- iFrames: ✅
- Codeblocks: ✅
- Head Metadata: ✅
- Checklists: ✅
- Images: ✅ (.png & .svg)
- Image resize: ✅
- Image converter: ✅ (.jpg, .png, .webp)
- Themed Images: ✅ (light & dark mode)
- Files: ✅ (.pdf, .docx, ..)
- Excalidraw: ✅ (light & dark mode)
- diagrams.net ✅ (light only mode)
- Math Equaitons: ✅
- Mermaid: ✅
- UML Diagrams: ❌ (not supported in Docusaurus)
- D2 Diagrams: ❌ (not supported in Docusaurus)
- Docusaurus Tabs: ❌ (not supported in Obsidian)
- MDX Support: ❌ (not supported in Obsidian)
If you need more info, help or want to provide general feedback, join our Obsidiosaurus Discord Channel.
Mat4m0 - Matthias