Overview
MoltenObsidian is a performant, open-source .NET library (targeting .NET 8+) that serves as a lightweight and extensible alternative to Obsidian Publish, enabling seamless integration of Obsidian-flavoured Markdown and full vault navigation into your applications — particularly Blazor-based ones.
Key strengths include extensibility, robust YAML frontmatter support, and data-source modularity—making it ideal for documentation sites, wikis, and custom content workflows.
Features
-
Markdown Parsing & HTML Conversion
Easily convert Obsidian-flavoured Markdown to HTML. For example:
using Nodsoft.MoltenObsidian; ObsidianText obsidianMarkdown = new(@" # Hello, world! This is a sample Markdown document with **bold** and *italic* text. "); MarkupString htmlText = obsidianMarkdown.ToHtml();
-
Blazor Integration
Turn your vault into a navigable Blazor component with minimal setup by using
AddMoltenObsidianBlazorIntegration()
and filesystem vault support. -
Vault Source Extensibility
Pick from multiple vault providers or implement your own:
- Filesystem – Load vaults directly from local directories
- HTTP – Stream vaults over HTTP via a manifest, improving efficiency and distribution
- FTP/SFTP – Access vaults stored on FTP/SFTP servers
- In-Memory – Use in-memory vaults for testing or dynamic content scenarios
Other sources can easily be implemented by community contriibutions.
- Filesystem – Load vaults directly from local directories
-
YAML Frontmatter & Routing
Full support for extended frontmatter and deep vault navigation with routing allows integration into rich documentation systems
-
CLI Tool
A command-line tool to manage vault manifests and static exports:
- Generate vault manifests listing file paths, sizes, and checksums.
- Export vaults as static HTML (SSG) from local or remote sources (HTTP, FTP).
Impact & Adoption
MoltenObsidian has garnered a modest but meaningful open-source community:
- ~80 GitHub stars, demonstrating community interest.
- Hundreds of thousands of NuGet Downloads across packages (Core library, Blazor integration, CLI tool), indicating real-world usage.
- Supports modern .NET ecosystems, initially from .NET 6, through .NET 8 currently, ensuring compatibility across many current deployments.
Open Source & Community
MoltenObsidian is released under the MIT license, promoting open collaboration, transparency, and broad adoption. The project welcomes contributions, especially for new vault providers or custom rendering logic.
About NSYS
MoltenObsidian is part of the broader ecosystem developed at Nodsoft Systems, where expertise in hosting and software engineering meets a strong focus on developer experience and open-source tooling, by providing developers with powerful, accessible, and extensible libraries that enhance productivity and empower modern .NET applications.
By bridging the gap between Obsidian’s knowledge-management workflows and enterprise-grade .NET applications, MoltenObsidian expands the NSYS portfolio into documentation, publishing, and developer tooling. It reflects the company’s commitment to building not only secure systems, but also the tools and frameworks that help others build reliable, scalable, and transparent solutions across industries.