Markdown on emsenn.net

Frontmatter Metadata

Wed, 31 Dec 2025 00:00:00 +0000

Frontmatter is a YAML header that records metadata for a markdown file.

Purpose

Identify the document (id, title or name).
Record provenance (authors, date-created).
Provide routing data (tags, dependencies, references).

Consistency

Keep metadata stable and machine-readable so tools can query a vault reliably.

Markdown Files

Wed, 31 Dec 2025 00:00:00 +0000

Markdown files are plain-text documents that mix human-readable prose with a small set of structural markers.

Structure

A file may begin with YAML frontmatter.
Headings provide a hierarchy of sections.
Links connect files and build a network of references.

Data view

Treat each file as a node with:

an identifier,
a title,
tags and dependencies,
outbound links and references.

Markdown Vault Workflows

Wed, 31 Dec 2025 00:00:00 +0000

GnoponEmacs should make it easy to navigate and edit a markdown vault.

Core workflows

Open a vault root and browse by file, tag, or link.
Jump between linked files and maintain backlinks.
Inspect and edit frontmatter with minimal friction.

Semiotic extensions

Surface interaction terms from headings and links.
Generate or open vault index files for overview navigation.

Markdown Vaults

Wed, 31 Dec 2025 00:00:00 +0000

A vault is a collection of markdown files treated as a linked knowledge base.

Vault properties

Files are nodes; links are edges.
Frontmatter supplies stable identifiers and metadata.
Index files summarize the vault and provide entry points.

Vault hygiene

Keep id values unique and stable.
Normalize tags and dependencies.
Track missing or broken links for repair.