metadata for individual markdown files. set in YAML frontmatter at the top of the file.
fields
| field | description | example |
|---|---|---|
| title | page title (overrides filename) | title: My Post |
| date | publication date | date: 2026-01-01 |
| tags | comma-separated tags | tags: blog, tech |
| description | page description for SEO | description: A post about... |
| author | content author | author: anton |
title
overrides the filename in listings and browser tab:
---
title: Getting Started with tinydot
---
without title, the filename is used (e.g., getting-started.md displays as "getting-started").
date
controls sorting and display in folder listings:
---
date: 2026-01-01
---
format: YYYY-MM-DD. pages with dates sort chronologically.
tags
two ways to add tags:
frontmatter tags
---
tags: blog, tech, personal
---
hashtags in content
this post is about #tech and #programming
both methods work together - tags are merged into a single list.
tag pages
each tag gets a page at /tags/tag-name showing all pages with that tag.
conventions
- use lowercase:
technotTech - use hyphens for multi-word:
machine-learning - avoid special characters
description
used for SEO meta tags and social sharing:
---
description: A comprehensive guide to getting started with tinydot
---
example
complete file with all metadata:
---
title: My First Post
date: 2026-01-01
tags: blog, announcement
description: Announcing my new site
author: anton
---
# welcome
this is my first post on tinydot.
related
- metadata - overview
- folder-metadata - folder settings
- markdown - content syntax