A-Blog

Customisable, extensible, complete Astro blog template

Fork or duplicate this repository, update site/config.json, and activate GitHub pages for the repository to go live.

All site-specific content under site/.

• Blog posts: site/posts/ (.mdoc or .md)
• Pages: site/pages/ (.mdoc or .md)
• Optional home page: site/pages/home.mdoc
• Header and footer: header.mdoc and footer.mdoc under site/components/

Note: Two posts with the same filename in different folders will collide.

• site/style.sass to define custom style (classes added available for use in .mdoc content)
• Refer to src/style/ for built-in CSS classes available for use in .mdoc content

npm install
npm run dev

description used as description meta tag

nav-index optional, used by {% nav /%} Markdoc tag for ordering pages

---
title: About
description: Phasellus finibus in elit et suscipit
nav-index: 1
---

date optional

---
title: Cras quis augue porttitor
description: Braesent pulvinar leo sagittis ipsum
date: 2026-05-23
---

{% block .a-css-class %}{% /block %} <!-- base block to apply CSS classes to -->

{% blog-posts count=10 show-description=true show-date=true /%} <!-- all attributes optional -->

{% nav /%} <!-- horizontal list of all pages -->

{% nav-link path="foo/bar" title="Bar" /%} <!-- link primary color when path active -->

• erenha.li
• monata.me
• ogoregen.com