obsidian2web

Author

  • chenxuan

Repository Address

Repository Description

  • ==Quickly deploy your obsidian notes to the web, and automatically update them according to git, or generate static resource files for notes==

  • Using mdbook and obsidian-export with GitHub's cicd and page implementation, and optimization, optimization reference

  • Requires a certain level of git and GitHub usage

Quick Start

Video Tutorial

Need to deploy to GitHub page

  1. Fork this repository

  2. Enable github-action repository page -> Actions -> Enable

  3. Add token permissions: Repository page -> Setting -> Action -> General -> Workflow permissions -> Click Read and write permissions

  4. Set page: Repository page -> Setting -> Pages -> Build and deployment -> Source set to Github Actions

  5. Put your obsidian notes under example (or copy or link)

  6. After each change, push directly to GitHub to automatically trigger the deployment process of the GitHub page

Repository in use

  1. Add this repository as a submodule

  2. Pull submodule along with repository in CI/CD

  3. Similar steps as above, but you need to write your own CI/CD file, CI/CD file reference

Only need to generate static files, no need to deploy

This is only applicable to linux (because the author is using a linux system)

  1. Clone this repository

  2. Run init.sh to download mdbook and obsidian-export. This step defaults to downloading the linux version. If you need another system version, please download it yourself

  3. Run create.sh <path to your repository>, at this point the generated book folder is the required static file, you can deploy it on your own server

Features

Comparison of Methods

  • Current implementation of commonly used methods for displaying obsidian notes on the web
MethodRepository Structure SupportExport SpeedAutomation LevelAutomated DeploymentFeature Completeness SupportDomestic AccessFree
obsidian webpage plugin
SupportedSlow, must be done in obsidian, obsidian must be openRequires manual clicking and waiting for export, obsidian must be openOnly supports webpage generation, cannot be directly deployed automaticallyAlmost complete support for all obsidian featuresSlow loading due to slow css resourcesFree
obsius pluginNot supported, only single documentFast, but unstable, depends on network and serverRight-click on a noteDeploy directly to someone else's server, not necessarily stableBasic support for obsidian featuresUnstable, as it is a foreign websiteFree, but unstable
obsidian2webSupportedFast, exported directly from mdCombined with git, can be seamlessly updated and deployed with git pluginMultiple methods, can choose github page deployment, or generate static webpage for self-deploymentBasic support for obsidian featuresAll css and js files are built-in, fast loadingFree
obsidian-digital-gardenSupports, no directory treeFast, because it is a single-page releaseEarly registration and other troublesome operations are required for single-page releaseSimilar to the obsius pluginSupports basic obsidian featuresSlow loading speed due to referencing some slow css resourcesFree
Official release serviceSupportFastHighHighSupports all featuresNormal, loading speed is acceptable$8 per month

QA

  • The book's configuration information is in the repository's book.toml, meaning refer to mdbook

  • If you find this repository helpful, feel free to give it a starā­ ; )