← Back to Articles

Getting Started with Your Knowledge Base

Welcome

This is your personal knowledge base — a place to dump everything you know, learn, and think about. Just write markdown files, drop them in the posts/ folder, and they'll be published automatically.

How It Works

The system is dead simple:

  1. Write a .md file with frontmatter
  2. Drop it in posts/
  3. The watcher detects the change and rebuilds
  4. Nginx serves the new static HTML

No databases. No CMS. No JavaScript frameworks. Just markdown in, HTML out.

Frontmatter

Each post starts with a YAML-like header:

---
title: Your Post Title
date: 2026-03-06
tags: tag1, tag2
category: Category Name
excerpt: A short description for cards and SEO.
cover: /static/images/cover.jpg
draft: false
---

Only title is truly required — everything else has sensible defaults.

What You Get

  • Search — instant client-side filtering
  • Tags — auto-generated tag pages
  • RSS — feed.xml for subscribers
  • TOC — auto table of contents for long posts
  • Code highlighting — Pygments-powered syntax colors
  • Responsive — looks great on mobile

Tips

Write messy first, polish later. The goal is to capture knowledge, not win a Pulitzer.

Use this as your second brain. Future you will thank present you.