Lesson 2

Why Markdown & setting up your structure

Learn why Markdown is AI’s native language, essential syntax, YAML frontmatter, and how folder paths give files meaning for your assistant.

~20 min Output: Knowledge/, Tasks/

What You'll Learn

📄

Why Markdown / .md is AI’s native language

LLMs are trained heavily on Markdown - it’s the format they parse and generate most reliably.
📚

Markdown syntax basics

Headings with #, lists with -, bold with ** - enough to structure any note.
🧮

YAML frontmatter

Structured metadata at the top of files so you (and AI) can query, filter, and organize content.
📁

Semantics by location

Folder path tells the AI what a file is - Knowledge vs Tasks carries meaning without extra explanation.

Get Started

Start this lesson

Paste this into your AI assistant Use the browser connector to read the lesson file at https://patrickwalther.ch/personal-os/lessons/02-why-markdown-and-setup.md and teach me. You're the teacher - go one step at a time and wait for my responses.

Need the lesson files? Download from GitHub

Why Markdown & setting up your structure

Why Markdown / .md is AI’s native language

Markdown syntax basics

YAML frontmatter

Semantics by location

Start this lesson