Back to blog

Blog

Welcome to the Blog

Shivank Poudel2 min read
metanextjsmarkdown

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.