Why Programmers Should Take Notes

Note-taking isn't just for students. As a programmer, your notes become your second brain — a place to store solutions, ideas, and everything you learn.

When I started programming, I thought I could remember everything. Syntax, shortcuts, error solutions — it all seemed manageable. But as I learned more, things started slipping through the cracks. How many times have you solved the same error twice? Or forgotten that perfect command you discovered last week?

That's when I discovered the power of note-taking. Here's why it matters and how different tools can help.

The Forgetting Curve

Hermann Ebbinghaus pioneered research on memory in the late 19th century. His forgetting curve shows that we forget about 50% of new information within an hour, and up to 70% within 24 hours. Without reinforcement, most new knowledge simply vanishes.

For programmers, this means:

  • That clever Git command you discovered? Gone in a day.
  • The solution to that obscure bug? You'll search for it again.
  • That architecture insight from a tech talk? Lost forever.

Notes are your defense against the forgetting curve. They capture knowledge so you don't have to rely on memory alone.

Popular Note-Taking Tools for Programmers

📝 Notepad / Simple Text Files

The simplest approach. Just plain text files organized in folders. No fuss, no learning curve. Many developers keep a ~/notes/ directory with Markdown files. It works because it's always there, always fast, and never gets in your way.

Best for: Quick notes, temporary scratchpads, minimalists.

⚡ Obsidian

This is what I personally use. Obsidian builds a personal knowledge graph from your Markdown notes. You can link notes together with [[wiki-style links]] and visualize connections. It turns your notes into a web of knowledge, not just a collection of files.

The graph view shows you how ideas connect. You might start with separate notes on "Rust ownership" and "memory safety" — Obsidian helps you see they're related. Over time, your notes grow into something greater than the sum of their parts.

Best for: Building a connected knowledge base, long-term learning, visual thinkers.

🌲 Other Great Tools

  • Notion — All-in-one workspace with databases and rich formatting. Great for project documentation and team wikis.
  • Joplin — Open-source, encrypted, with markdown support. Good privacy-focused alternative.
  • VSCode with Foam — If you live in your editor, Foam turns VSCode into a note-taking powerhouse.
  • Google Docs / OneNote — If you prefer cloud-based, collaborative tools. This is great for team collaboration and sharing notes too.

What to Take Notes On

Here's what I've found valuable to document:

  • Error solutions — When you fix something tricky, write down the solution. Future you will be grateful.
  • Commands and shortcuts — That complex git command you use once a month? Write it down.
  • Project decisions — Why you chose one approach over another. Future maintainers (including yourself) will thank you.
  • Book and article summaries — Capture key insights before you forget them.
  • Code snippets — Patterns you reuse, clever implementations, useful functions.
  • Learning progress — What you're studying, what you've learned, what's next.

My Obsidian Setup

I mentioned I use Obsidian, so here's a peek at my workflow:

  • Daily notes — Each day gets a note with what I worked on, learned, or thought about. These become a searchable journal of my work.
  • Permanent notes — When a daily note contains something useful, I extract it into a permanent, well-organized note.
  • MOCs (Maps of Content) — Notes that act as indexes, linking to other notes on a topic. Like a table of contents for my knowledge.
  • Tags and links — I tag notes by language, project, or topic. Links connect related ideas.

Getting Started

You don't need a complex system. Start simple:

  1. Create a notes folder somewhere
  2. When you learn something useful, write it down in a text file
  3. When you have a few files, try linking them together
  4. Explore tools like Obsidian when you feel limited by plain files

The palest ink is better than the best memory.

— Old Chinese proverb

Your brain is for having ideas, not storing them. Start taking notes today — your future self will thank you when you need to remember that obscure fix or that brilliant insight you had months ago.

Comments