Astro static rendering by default, pages primarily in HTML, using JavaScript only when necessary
astro-blog-template — Astro Blog Template
By jonadev-ok
A static blog template based on Astro, using MDX, Tailwind CSS, and a Preact search island, suitable for developers and content creators to build personal blogs.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Write articles using MDX, supporting embedding components in Markdown
Manage content through typed Content Collections
Automatically generate article table of contents and display reading time for each
Tailwind CSS styling and reusable components, responsive layout
Preact + Fuse implement a client-side search island, and includes search engine optimization
Template Details
This is a blog template built with Astro. It uses static rendering by default, with pages primarily in HTML and JavaScript loaded only when needed. The content layer uses MDX to write rich-text articles and organizes content through typed Content Collections, with an automatically generated table of contents and reading time for each article. Styling is provided by Tailwind CSS, interface components are reusable, and the layout is responsive. The search function is implemented as a Preact island, paired with Fuse for client-side retrieval, so search capability depends on JavaScript loading; the template also includes search engine optimization. The tech stack is Astro, MDX, Tailwind CSS, Preact + Fuse, and TypeScript. The repository uses the MIT license, allowing free use, modification, commercial use, and distribution of this version of the code, but third-party assets such as demo images, fonts, and icons require separate license verification, and external services such as domains and hosting may incur costs.
Is it right for your project?
Use Cases
- Build a personal tech blog and publish MDX-format articles
- Provide a content display site for developer portfolios or writing projects
- Blog scenarios requiring article table of contents, reading time, and site search
- Sites primarily using static output and wishing to reduce client-side JavaScript
Suitable For
- Developers familiar with Astro or willing to learn Astro
- Content creators writing in Markdown/MDX
- Small blog projects requiring reusable components and scalable content structure
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
The repository uses the MIT license; when distributing copies or substantial portions of the code, retain the copyright notice and the full MIT license notice
- 2
Third-party assets such as demo images, fonts, and icons require separate verification according to their respective licenses
- 3
External services such as domains and hosting may incur additional charges; confirm costs yourself
- 4
The search function depends on the Preact island and Fuse, and is unavailable when JavaScript is disabled
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version of the code are allowed.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- The site is primarily HTML, loading JavaScript only when necessary; the search function depends on the Preact island and Fuse, and site search is unavailable when JavaScript is disabled.
- Contributing code requires first reading the contribution guidelines and process in the repository's CONTRIBUTING.md.
- Demo images, fonts, icons, and other third-party assets require verification according to their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
The site uses **HTML-first** and JavaScript only when necessary necessary.
Original README
https://github.com/jonadev-ok/astro-blog-template/blob/main/LICENSEhttps://github.com/jonadev-ok/astro-blog-template/blob/main/README.mdIf you are interested in contributing, click here for more [information](https://github.com/jonadev-ok/astro-blog-template/blob/main/CONTRIBUTING.md)
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-03. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- Astro Themes
- Documentation and maintenance reference score
- More documented · 83 / 100
- Technologies
- Astro
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-03-04
- Screenshot last checked
- 2026-10-03
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Astro as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: [email protected] · 2026-10-04
Inspect the recorded source material
SHA-256: bea98d7c2aa1acdcc9d4131a8dca2ef34e7ca37cb84e6e95cbfd580c57cf7da9
2026-10-03T23:10:54.776Z
Source file / repository# 💻 Blog template created with Astro <details> <summary>Click to see technical details</summary> ### ✨ Features: - ⚡ **Astro** with static rendering by default - 📝 **MDX** for rich content - 🎨 **Tailwind CSS** for styles - 🧩 Reusable components - 🗂️ Typed **Content Collections** - 📚 Automatic table of contents - ⏱️ Reading time per article - 📱 Responsive layout - 🔍 Search engine optimized with Preact - 🚀 Excellent performance and SEO ### 🧱 Technology stack: - Astro - MDX - Tailwind CSS - Preact + Fuse (for search island) - TypeScript The site uses **HTML-first** and JavaScript only when necessary necessary. </details> <div align="center"> <img width="1920" height="1080" alt="682shots_so" src="https://github.com/user-attachments/assets/7bd1b263-0f0d-4720-b5ff-e1263e28652f" /> <p></p> </div> <div align="center">        </div> > [!NOTE] > If you are interested in contributing, click here for more [information](https://github.com/jonadev-ok/astro-blog-template/blob/main/CONTRIBUTING.md) ## 🫂 Contributors <a href="https://github.com/jonadev-ok/astro-blog-template/graphs/contributors"> <img src="https://contrib.rocks/image?repo=jonadev-ok/astro-blog-template"/> </a> <p></p>
Explore similar templates
Compare previews and descriptions within the same stack and category.

astrowind
AstroWind is a free, open-source Astro starter theme using Astro and Tailwind CSS, released under the MIT license.
Astro · Blog

astro-paper
AstroPaper is a minimal, responsive, accessible, and SEO-friendly Astro blog theme. Articles are stored as Markdown/MDX in src/content/posts/, with subdirectories affecting URLs.
Astro · Blog

fuwari
Fuwari is a static blog template built with Astro and Tailwind CSS for personal blogs. It manages posts as Markdown files in src/content/posts/, with frontmatter for title, date, description, cover, tags, categories, draft status, and language.
Astro · Blog

Firefly
Firefly is a clean personal blog theme forked from Astro and Fuwari, offering four background modes, single/double sidebar and list/grid layouts, Pagefind client-side full-text search, and a six-language UI.
Astro · Blog

astro-theme-cactus
Astro Cactus is an Astro-based blog and portfolio theme that uses Markdown/MDX content collections to manage posts, notes, and tags, with frontmatter type-checked by a schema.
Astro · Portfolio

astrofy
Astrofy is a free and open-source personal portfolio website template built with Astro and TailwindCSS, with built-in blog, CV timeline, project showcase, store, and RSS feed modules.
Astro · Portfolio
