██   ██ ███    ██  ██████  ██     ██ ██      ███████ ██████   ██████  ███████ 
██  ██  ████   ██ ██    ██ ██     ██ ██      ██      ██   ██ ██       ██      
█████   ██ ██  ██ ██    ██ ██  █  ██ ██      █████   ██   ██ ██   ███ █████   
██  ██  ██  ██ ██ ██    ██ ██ ███ ██ ██      ██      ██   ██ ██    ██ ██      
██   ██ ██   ████  ██████   ███ ███  ███████ ███████ ██████   ██████  ███████ 

knowledge

knowledge is a personal knowledge base. Its genesis lies in my desire to capture almost everything I know in one place, structured and searchable for easy retrieval.

Principles

• Typed — every note carries at least one kind (application, concept, operating-system,
  format, …) with structured frontmatter defined by schema.json and described in
  Meta.md. The kind is implicit: whichever kind-object is present is the note's type.
• Derivable — index and overview pages ("meta views") are meant to be generated from that
  frontmatter rather than hand-maintained. Add a note with the right data and the rollups follow.
• Plain & portable — notes are plain-text markdown with relative
  links between them. No editor lock-in; any markdown editor works.
• Published — the repository is rendered to a static website with
  Quartz.

Topics

• 🔬 Science
  • 🧬 Biology
  • ⚗️ Chemistry
  • 📊 Math
  • 🤔 Philosophy
  • 🌌 Physics
• 💻 Technology

Workflow

• Tooling: jsaw is the primary tool — it validates
  frontmatter against the schema (jsaw validate), queries notes as a table (jsaw db), renders
  meta views from data (jsaw render), and patches frontmatter (jsaw patch). The dev environment
  is declared in flake.nix; run nix develop to get jsaw and friends.
• Search:
  • ripgrep — full-text search across note content.
  • jsaw db — query notes by their frontmatter metadata.
• Editing: any markdown editor. Obsidian and
  VSCode work, but nothing relies on
  editor-specific features — the repo stands on its own.
• Browsing: the published site, or online via Gitea.

Contributing

If you want to contribute or fix some notes, take a look at these files:

• Guide.md — a guide and checklist for adding and maintaining notes consistently.
• Meta.md — describes schema.json, the frontmatter format every note follows.