Plaintext First
Crucible is built on a simple principle: your notes are just files. Markdown files in folders on your computer. No database required, no cloud dependency, no proprietary format.
Why Plaintext
Section titled “Why Plaintext”Portability
Section titled “Portability”Your notes work everywhere:
- Any text editor (VS Code, Vim, Obsidian, Notepad)
- Any operating system
- Any device
- Any decade - markdown will outlive any app
Ownership
Section titled “Ownership”Your files live on your machine:
- No company holds your data hostage
- No subscription to access your notes
- No internet required to write and read
- You control backups and sync
Simplicity
Section titled “Simplicity”Files are simple:
- No migration when tools change
- No export/import workflows
- Version control with Git
- Scriptable with standard tools
What Crucible Adds
Section titled “What Crucible Adds”Crucible enhances your files without changing them:
| Your Files | Crucible Cache |
|---|---|
| Source of truth | Derived data |
| Portable markdown | Local database |
| Always accessible | Rebuilt anytime |
The database (SQLite by default) is a cache. Delete it and Crucible rebuilds it from your files. Your notes are never modified unless you ask.
The Markdown Contract
Section titled “The Markdown Contract”Crucible commits to:
- Never require proprietary format - Standard markdown works
- Never lock you in - All features work with plain files
- Never modify without consent - Your files, your control
- Always be rebuildable - Cache from source, not source from cache
Wikilinks and Extensions
Section titled “Wikilinks and Extensions”Crucible uses [[wikilinks]] - a widely-supported markdown extension. These work in Obsidian, Logseq, Foam, and many other tools.
Other extensions (frontmatter, block references) are also standard across the PKM ecosystem.
See Also
Section titled “See Also”- Kilns - What makes a kiln
- Frontmatter - YAML metadata (standard format)
- Wikilinks - Link syntax (widely supported)