User Manual
karaoke-cms is an Astro framework for publishing Obsidian vaults as static sites. You write notes in Obsidian, add publish: true to the ones you want public, and the framework builds a fast static site from them. Everything stays private by default.
Install with one command: npm create @karaoke-cms@latest.
Where to start
Iām a developer ā comfortable with npm, TypeScript, and Git. I want to get a site running and understand how to configure it. Start here: Quick start for developers
I use Obsidian ā I want to publish some of my notes without learning a lot of new tools. Start here: Quick start for Obsidian users
Sections
Getting Started
Installation, first steps, and the ideas behind karaoke-cms.
Writing Content
Authoring pages: Markdown, privacy rules, wikilinks, and media.
Modules
Built-in modules: blog, docs, tags, search, comments, SEO, AI enrichment, and menus.
Customization
Themes, custom modules, custom themes, and the CSS contract API.
Operations
Deploying, debugging, and upgrading your site.