Tip
For more information, read posts:
- Demo #1 - GitHub Pages (https://galacsh.github.io/blog-template/posts)
- Demo #2 - Vercel (https://galacsh-blog-template.vercel.app/posts)
This is a simple blog template for personal blogs. This template generates pages from markdown files and builds a static site. So it can be hosted on any static site hosting service, such as Vercel, Netlify, GitHub Pages, etc.
This template doesn't use MDX or @next/mdx directly. Instead, it uses Unified to parse markdown files and convert them to React components.
Even though this template is built
with the Next.js - App Router,
each post (markdown file) doesn't need to follow app routing conventions.
Markdown files placed in /posts directory will be automatically converted to pages.
This means the template can also be used with Obsidian vaults with some tweaks.
Theme supports dark mode and responsive design, and is inspired by the Next.js - Docs and the VitePress - Guide.
- Static export
- Landing page
- Dark mode support
- Responsive design
- Markdown file processing
- Posts filtering
- Posts sorting
- Command Menu
- Copy link to clipboard button
- Quick scroll button
- Related posts (Show posts in same directory)
- On this page (Table of contents)
- Draft
- Error page
-
sitemap.xml -
robots.txt
I didn't want to follow app routing conventions for each post.
I wanted to have more control over the markdown parsing process.
For example:
- Caching the list of posts and their metadata
- Handle slug generation
By the time I started this project, it seemed like the project was not actively maintained and unstable.