Astro Blog Markdown

Astro Blog Markdown is a starter template by Rodney Lab for building a fast, accessible, SEO-friendly blog using Astro, Markdown, and a spot of Svelte. This open-source repository scaffolds a complete Astro site that reads posts written in Markdown and generates a static blog with a focus on performance and search visibility, as evidenced by a Lighthouse score of 100 in every category shown in the project's own screenshot.

What is Astro Blog Markdown?

Astro Blog Markdown is a GitHub starter project that acts as the foundation for a Markdown-based content site built with the Astro framework. It takes Markdown files as content input and produces a static blog site with HTML, CSS, and JavaScript as output, including interactive Svelte components where needed. The template was created by Rodney Lab, who also published an accompanying how-to article on getting started, and it is shared on GitHub under the topics astro, blog, markdown, starter, and svelte.

Key Features

• Markdown-first authoring — Write blog posts in Markdown and let Astro convert them into static pages without a database or CMS.
• Svelte integration — The starter uses Svelte for client-side interactive islands, letting you add dynamic behavior with minimal JavaScript.
• Astro Picture component — Included for responsive images in Markdown-based content sites, using Astro Content Collections to handle image optimization.
• Accessibility and SEO focus — The starter is designed for accessible markup and search-engine-friendly output, with details covered in Rodney Lab's related blog posts.
• Lighthouse perfect score — The repository's own screenshot shows 100 scores across performance, accessibility, best practices, and SEO.
• One-command scaffolding — Install with pnpm create astro@latest -- --rodneylab/astro-blog-markdown and then copy .env.EXAMPLE to .env to start developing.
• Netlify deployment ready — A Netlify deploy status badge links to a live site built from this template, showing it is compatible with Netlify.
• StackBlitz support — An Open in StackBlitz button lets you run and edit the template directly in the browser.

Who is it for?

• Independent bloggers who want a fast, static blog without configuring a full CMS and who are comfortable writing Markdown files.
• Astro developers looking for a lightweight starting point that already wires up Svelte components and Astro Content Collections.
• Performance-conscious site owners who want a template that scores 100 on Lighthouse out of the box and can be deployed to Netlify easily.

What can you do with it?

• Publish a Markdown blog: Write posts as Markdown files, add them to the content collection, and build a static blog with the included commands.
• Add responsive images: Use the Astro Picture component within Markdown content to serve optimized, responsive images without hand-coding picture elements.
• Deploy to Netlify: Push the repo to a Netlify-connected Git host and use the project's existing Netlify configuration to go live.
• Preview and build locally: Run pnpm run dev for a local server at localhost:3000, and pnpm run build to generate the production site in ./dist/.

How does it work?

1. Scaffold a new Astro project by running pnpm create astro@latest -- --rodneylab/astro-blog-markdown.
2. Copy the environment file with cp .env.EXAMPLE .env.
3. Start the dev server with pnpm run dev, which serves the site at localhost:3000.
4. Build for production with pnpm run build, outputting to ./dist/, and preview with pnpm run preview.

FAQ

Is Astro Blog Markdown free?

Yes. The template is an open-source starter hosted on GitHub, so you can use, modify, and deploy it without paying a license fee. It is also available for instant experimentation through StackBlitz.

Does Astro Blog Markdown use a CMS?

No. It is a Markdown-based starter; you author content in Markdown files rather than through a separate CMS. It uses Astro Content Collections to manage those Markdown files, and the related guide explains how to add responsive images to such a site.

What do I need to run it?

You need Node.js and pnpm installed. The template provides pnpm-based commands for installing dependencies, running a dev server, building the production site, and previewing the build.