Building a Modern Personal Knowledge Base

Keeping information organized is becoming more important every year. Between articles, videos, bookmarks, and notes, it's easy to lose track of valuable information.

This guide explains how you can build a personal knowledge base using nothing more than Markdown and a simple folder structure.

Why Markdown?

Markdown is:

  • Lightweight
  • Portable
  • Easy to learn
  • Git-friendly
  • Future-proof

Unlike proprietary note-taking apps, Markdown files remain readable for decades.

"Own your notes. Don't let your notes own you."

Folder Structure

A simple organization works surprisingly well.

knowledge-base/
│
├── articles/
├── notes/
├── projects/
├── assets/
│   ├── images/
│   └── files/
└── README.md

Keeping assets separate prevents your folders from becoming cluttered.

Basic Formatting

Markdown supports several formatting options.

Bold

This is bold text

Italic

This is italic text

Strikethrough

Old information

Inline Code

Use the fetch() API to retrieve data.

Lists

Unordered

  • Apple
  • Banana
  • Orange
    • Small
    • Large

Ordered

  1. Install Node.js
  2. Create a project
  3. Write code
  4. Deploy

Task List

  • Create repository
  • Configure project
  • Write documentation
  • Publish article

Code Example

async function fetchArticles() {
    const response = await fetch("/api/articles");
    const articles = await response.json();

    console.log(articles);
}

fetchArticles();

Python Example

def fibonacci(n):
    a, b = 0, 1

    while a < n:
        print(a)
        a, b = b, a + b

fibonacci(100)

Quote

Great documentation is written for humans first, machines second.

Table

Feature Supported Notes
Headings ✅ Up to H6
Tables ✅ GitHub Flavored Markdown
Code Blocks ✅ Syntax Highlighting
Images ✅ Local & Remote
Footnotes ✅ Optional

Horizontal Rule

Image

Workspace

Blockquote with Attribution

Simplicity is the ultimate sophistication.

— Leonardo da Vinci

Keyboard Keys

Press Ctrl + S frequently.

Emoji

🚀 Markdown is fun.

✨ Keep writing.

🎉 Publish confidently.

Callout Example

Note

Always keep backups of your notes.

Nested List

  • Frontend
    • HTML
    • CSS
    • JavaScript
      • React
      • Vue
      • Svelte
  • Backend
    • Node.js
    • Go
    • Rust

Sample JSON

{
  "title": "Hello Markdown",
  "published": true,
  "views": 1203,
  "tags": [
    "markdown",
    "notes",
    "blog"
  ]
}

Sample YAML

site:
  title: Articles
  author: Hirdaya Shrestha

theme:
  mode: dark

Sample HTML

<div class="card">
    <h2>Hello World</h2>
    <p>This is HTML inside Markdown.</p>
</div>

Checklist Before Publishing

  1. Verify title
  2. Add cover image
  3. Optimize metadata
  4. Check grammar
  5. Test links
  6. Publish

Footnotes

Markdown even supports footnotes.[^1]

[^1]: Footnotes are supported by many Markdown parsers including GitHub Flavored Markdown.

Conclusion

Markdown remains one of the best formats for long-term writing.

Whether you're building:

  • a blog,
  • a documentation website,
  • a personal wiki,
  • or an article platform,

Markdown provides an excellent balance between simplicity and power.

Happy writing! 🚀