LVlqvinh.dev
SearchGitHubLinkedInView CV

Article

Building an Offline-First Knowledge Hub with Obsidian

A Markdown-first workflow for private notes, public articles, research references, and website publishing.

Aug 25, 20261 min read
markdownobsidianknowledge-managementgit

Goal

The website should not become the only place where knowledge exists. The source of truth is plain Markdown that remains useful in Obsidian, VS Code, GitHub, and future tools.

Public boundary

Keep the whole vault private by default, then explicitly sync only public folders:

KnowledgeHub/Public/Articles
KnowledgeHub/Public/Notes
KnowledgeHub/Public/Research

Publication rule

A note should be published only when metadata says both:

public: true
status: published

That small gate avoids accidentally publishing private drafts or unfinished research notes.