Quantum OS Note Naming Rules

These are the Quantum OS file naming conventions used to identify notes that I write.

Changelog

• 2026-01-19—Replaced requirement for Concept notes and Structure notes to be lowercase with Sentence case. The use of lowercase to identify these note types does not add any semantic meaning of note and makes reading more difficult, plus requires the need to autoconvert titles on The Quantum Garden Website for the public’s benefit.

The filename is the title

A note’s filename is the title of the note with The Quantum Garden Vault and must be formatted with the correct case.

• Sentence case
  • default for all notes not treated differently as listed below
• Title case
  • use for named entities (people, books, video games, etc.) and other items with an official identity.
  • if the title has an illegal file system character (i.e., ”:” or ”?”) then that character replaced with a ”-” and may be display replaced by following the Quantum OS Acceptable Use of Aliases.
  • if the named entity is a series and this is necessary to distinguish between a singular named entity then “(series)” is appended with lowercase.
• Kebab case
  • use for structural items such as folder names and code.

Singular not plural

All Concept notes must be named using the singular and not plural name.¹

Sources

A “source” is anything that is created by someone else and named according to the Quantum OS Source Naming Rules.

Sources includes books, papers and articles, YouTube videos, movies, tv-shows, etc.

Dates

A dated filename must begin with yyyy-mm-dd i.e., 2026-01-15-a-note.

Media thumbnails

• Media thumbnails are stored in public/assets/covers not matter where they are referenced. This reduces load in moving them separate from the original note although it does mean some will be loaded to The Quantum Garden Website with no associated note.
• Media thumbnails are named according to their type with Snake case. This is consistent with the historical convention in The Quantum Garden Vault and due to the volume of entries would need a programmatic change.
  • Book
    • bk_authorSurname_title_flickrImageSizeSuffix²
  • Movie
    • mv_title_flickerImageSizeSuffix²
  • TV Show
    • tv_title_flickerImageSizeSuffix²
  • Video Game
    • vg_title_flickerImageSizeSuffix²

Supporting files

• Obsidian bases
  • All stored in utilities\bases
  • Index bases start with @
  • Insertable bases start with _

Examples

• “file naming convention” (lowercase) because it defines what file naming conventions are.
• “list of file naming conventions” (lowercase) because the list is not about anything, but a collected set of items.
• “File naming conventions you should use” (Sentence case) because it is a discourse about recommended file naming conventions.
• “Quantum OS File Naming Rules” (Title case) because it is a named set of rules.

Footnotes

1. An alias may be used instead, see Quantum OS Acceptable Use of Aliases > Pluralisation. ↩

2. See Flickr image size suffixes ↩ ↩² ↩³ ↩⁴