Blog
Welcome to the Blog
This is the first post on the blog. It exists mostly to explain how the blog works, so that adding the next post is as simple as dropping a new file in a folder.
Writing a post
Every post is a single Markdown file under content/blog/. The file name
becomes the URL slug, so content/blog/welcome-to-the-blog.md is served at
/blog/welcome-to-the-blog.
Each file starts with a small block of frontmatter — the same idea Jekyll popularised — that holds the metadata:
---
title: "Welcome to the Blog"
date: "2026-06-15"
excerpt: "A one-line summary used on the index page."
tags: ["meta", "nextjs", "markdown"]
author: "Shivank Poudel"
---
Everything below the frontmatter is ordinary Markdown.
What you can use
The renderer supports GitHub Flavored Markdown, so the usual building blocks all work:
- Bold, italic, and
inline code - Ordered and unordered lists
- Links, blockquotes, and images
- Fenced code blocks with a language hint
- Tables
Markdown keeps the writing close to plain text, which makes posts easy to diff in pull requests and easy to read even before they are rendered.
A quick table
| Feature | Supported | Notes |
|---|---|---|
| Code blocks | ✅ | With language-tagged styling |
| Tables | ✅ | Via GitHub Flavored Markdown |
| Task lists | ✅ | - [ ] and - [x] |
Why build it this way
The whole site is statically exported, so each post is turned into HTML at build time. There is no database and no server to run — the output is a folder of static files. That keeps the current GitHub Pages deploy fast and makes a future move to Vercel a matter of changing where the same build is published.
That's it. Read on, or check out the other posts from the blog index.