Frontmatter Standardization Guide

Overview

This document explains the standardization of YAML frontmatter across all Markdown files in the project. Frontmatter provides structured metadata at the beginning of Markdown files, which can be used for categorization, filtering, and displaying additional information about the content.

Standard Format

All Markdown files in this project now follow this consistent frontmatter structure:

---
title: Document Title
date: YYYY-MM-DD
tags:
  - tag1
  - tag2
  - tag3
---

Fields Explanation

  • title: The title of the document
  • date: The date in YYYY-MM-DD format
  • tags: A list of tags for categorization, using the indented list format

Changes Made

The following standardization changes were applied across all Markdown files:

  1. Added frontmatter to files that were missing it
  2. Standardized the format of existing frontmatter (removed quotes, fixed indentation)
  3. Updated generic tags (like "tag1", "tag2") with more meaningful ones
  4. Ensured consistent date format (YYYY-MM-DD)
  5. Added titles to files with empty title fields

Benefits

  • Consistency: All files now follow the same metadata structure
  • Improved parsing: Systems that parse frontmatter/graymatter can reliably extract metadata
  • Better organization: Meaningful tags help with content categorization
  • Enhanced search: Structured metadata enables more effective content discovery

Markdown Files Inventory

Below is a comprehensive list of all Markdown files in the docs directory, organized by subfolder:

Root docs/

  • content.md
  • frontmatter-standardization.md (this file)
  • getting-started.md

docs/chats/

  • 2025-Anime.md
  • ithy-jiddu.md

docs/hm-Admin/

  • pay-html.md
  • pay.md
  • Ai-gen-Video.md
  • val-town-links.md
  • yt-music-test.md

docs/subscriptions/

  • abacus.md
  • all-subs.md
  • chatgpt.md
  • club-carwash.md
  • cursor.md

docs/tech/

  • chrome-extensions.md

docs/test/

  • Accordion.md
  • callout.md
  • markdown-test.md
  • tabs.md
  • two-columns.md

docs/test-deep-research/

  • chatgpt-labor-gdp.md
  • perplexity-labor-gdp.md

docs/testing-llm/

  • 1.md

Maintenance

When creating new Markdown files, please follow the standardized frontmatter format outlined above. This ensures consistency across all documentation and improves the overall organization of content.