Free tool · works now

Note Inventory Generator

Generate a portable catalog of note titles, frontmatter properties, word counts, and links across your vault.

Runs 100% in your browser. Create comprehensive catalogs of note titles, YAML frontmatter properties, word metrics, and link networks across your Markdown vault.

5Notes cataloged
205Total words
41Avg words / note
3Stub notes (<50w)
1Missing titles
5Wikilinks
Markdown notes or multi-file bundleDelimiter: --- FILE: path.md ---

Paste multiple notes separated by --- FILE: path/note.md --- or paste individual note content directly.

Parsed note inventory matrix5 documents cataloged
Client Roadmap & Milestoneswork/client-roadmap.md ---
H1 Title
86 words (1 min)2 headings2 wikilinks1 attachments
⚠️ No YAML frontmatter found⚠️ No tags found in frontmatter or note body
Local Architecture Specificationwork/architecture-spec.md ---
H1 Title
50 words (1 min)1 headings2 wikilinks0 attachments
⚠️ No YAML frontmatter found⚠️ No tags found in frontmatter or note body
Books and Research Notespersonal/reading-notes.md
H1 TitleStub
32 words (1 min)1 headings1 wikilinks0 attachments
#books#literature#philosophy
⚠️ Low word count: note has only 32 words (stub note)⚠️ No YAML frontmatter found
2026-10-13.md ---daily/2026-10-13.md ---
FilenameStub
15 words (1 min)0 headings0 wikilinks0 attachments
⚠️ Missing explicit title (derived from filename fallback)⚠️ Low word count: note has only 15 words (stub note)⚠️ No YAML frontmatter found⚠️ No tags found in frontmatter or note body
Meeting Templatetemplates/meeting-template.md
H1 TitleStub
22 words (1 min)1 headings0 wikilinks0 attachments
⚠️ Low word count: note has only 22 words (stub note)⚠️ No YAML frontmatter found⚠️ No tags found in frontmatter or note body

Real-time audit. Download formula-guarded CSV or Markdown Map of Content (MOC) with the toolbar buttons above.

The Role of Note Inventories in Knowledge Base Governance

As personal knowledge management (PKM) vaults grow beyond a few hundred files, maintaining consistent metadata, valid titles, and structured taxonomies becomes challenging. Notes created during hurried meetings often lack explicit YAML frontmatter; experimental outlines remain as short stub drafts; and tags fragment into duplicate variants across folders. Without a comprehensive catalog, these incomplete files become invisible clutter that obstructs full-text search and knowledge discovery.

The Note Inventory Generator solves this problem by parsing your Markdown notes, evaluating frontmatter properties, extracting headings and tags, calculating word counts, and flagging missing metadata. By executing entirely within browser memory, it provides institutional-grade cataloging capabilities with 100% privacy and zero data leakage.

The Title Ambiguity Problem: YAML versus H1 versus Filename

In modern Markdown ecosystems like Obsidian, Logseq, and static site generators (Astro, Starlight), documents can define their human-readable title in three competing ways:

  1. YAML Frontmatter (title: My Document): The gold standard for static site publication and database indexing. Enables titles with punctuation, spaces, or characters that filesystems forbid.
  2. First Level-1 Heading (# My Document): CommonMark standard practice for standalone prose documents where frontmatter is omitted.
  3. Filesystem Basename (my-document.md): The fallback when no in-file title exists. Frequently leads to ugly slugified titles in navigation trees.

This generator applies an explicit three-stage election algorithm, tracking exactly where each title originated. When a note falls back to its filename, the tool flags it as an audit finding so you can add an explicit title before publishing.

Detecting Stub Notes and Incomplete Outlines

A common cause of vault clutter is the accumulation of stub notes: empty or nearly empty placeholder files created when clicking uncreated wikilinks ([[Topic]]). While stubs serve a purpose during exploratory brainstorming, forgotten stubs inflate graph views and dilute search results.

Our engine measures prose word counts (strictly excluding code blocks and frontmatter comments) and flags documents with fewer than 50 words as stubs. This allows you to quickly isolate notes that require fleshing out, merging, or pruning. Pair this with our folder structure visualizer and relative path calculator to reorganize and connect your vault hierarchy.

Consolidating Tag Taxonomies

Over time, note-takers oscillate between frontmatter property tags (tags: [research, ai]) and inline prose hashtags (#research). The inventory generator extracts and unifies both formats into a single deduplicated tag array per document. Reviewing the consolidated tag inventory in the exported spreadsheet makes it straightforward to spot casing discrepancies, pluralization mismatches (e.g. #book vs #books), and orphaned single-use tags.

Generating Maps of Content (MOC) and Formula-Guarded CSVs

The tool produces two primary deliverables:

Step-by-Step Vault Inventory Audit Protocol

  1. Bundle your notes: In your terminal, combine notes into a single manifest using a script or command like for f in *.md; do echo "--- FILE: $f ---"; cat "$f"; echo ""; done > bundle.md.
  2. Paste into the generator: Paste the bundled text into the input panel above. The matrix updates in real time.
  3. Inspect audit findings: Review the warning indicators for missing titles, unclosed frontmatter, missing tags, and stub notes.
  4. Export your catalog: Download the formula-guarded CSV to track remediation tasks or export the Markdown MOC to create an index note for your vault.

Questions

How does the Note Inventory Generator determine the title of each note?

The engine applies a strict three-tier priority resolution: First, it checks for an explicit title: property in YAML frontmatter. If absent, it extracts the first top-level Markdown heading (# Heading) from the note body. If neither exists, it falls back to the clean filename (without .md extension) and flags a missing explicit title warning.

Can I analyze my entire vault at once or just individual notes?

You can analyze any number of notes. Simply concatenate your notes with standard delimiter markers (--- FILE: path/to/note.md ---) or paste individual notes directly. The parser automatically splits the bundle into distinct files and generates a unified matrix.

What qualifies as a stub note in the inventory report?

Any note containing fewer than 50 words in its prose body (excluding code blocks and YAML frontmatter) is classified as a stub note. Identifying stubs helps you isolate placeholder files, abandoned outlines, or notes that need further expansion.

How does the tool distinguish between frontmatter tags and inline hashtags?

The generator inspects both locations: it parses frontmatter tags: (whether defined as bracket lists [work, client] or YAML list items) and scans the body text for inline hashtags (#tag), consolidating them into a single deduplicated list per note.

Why are spreadsheet formula guards applied to the CSV catalog export?

Note titles, file paths, or frontmatter tags starting with formula triggers (=, +, -, @, or tabs) could execute malicious macros when opened in Microsoft Excel or Google Sheets. The generator automatically prefixes vulnerable fields with an apostrophe to neutralize formula execution.

Does this tool transmit my notes or metadata over the network?

No. All text parsing, YAML extraction, word counting, and table generation execute exclusively inside your browser tab memory. Zero network requests or telemetry events are transmitted.

Bring order and governance to your note vault

Private on-device text intelligence and native Markdown editing in Oyma. Keep your note metadata clean and organized across devices.

tools note inventory generator downloadDownload for Mac

No account needed. Intel Mac build