Shiina-Astro-Blog is a blog theme and static site generator built with Astro and Vue that transforms Markdown and MDX content into a deployable blog, supporting both static (SSG) and server-side rendering (SSR) build modes.
What is Shiina-Astro-Blog?
Shiina-Astro-Blog is an open-source blog framework that combines the Astro site builder with Vue components for interactivity. It takes Markdown or MDX files as content input and outputs a static blog site; the repository's metadata lists support for both SSG and SSR build modes. The project is authored by QingXia-Ela and is available on GitHub, though the README announces it as deprecated in favor of a next-generation replacement.
Key Features
- Astro + Vue stack — Uses Astro as the core framework and Vue for interactive components, with TypeScript as the language according to the repository topics.
- SSG and SSR build modes — The repository description explicitly states support for both static site generation and server-side rendering, giving deployment flexibility.
- MDX content support — Posts are written in Markdown or MDX, allowing embedded components and richer formatting in articles.
- CLI workflow — A built-in command-line tool creates new posts with
npx blog nand pushes updates to git withnpx blog d, automating the writing and deployment loop. - SEO-friendly — The repository topic list includes SEO-friendly, indicating the theme is designed with search engine visibility in mind.
- User guide included — The README links to a documentation file at docs/user/概览.md that explains how to use the theme.
Who is it for?
- Astro developers — Use this theme as a starting point for a personal blog, then customize the Astro and Vue components to fit your own design.
- Writers who prefer Markdown — Manage content entirely through Markdown or MDX files and create posts from the terminal instead of a CMS.
- Self-hosters — Since the blog can be built into static files, you can deploy it to GitHub Pages, Netlify, Vercel, or any static hosting service.
What can you do with Shiina-Astro-Blog?
- Start a blog quickly — Clone the repository, install dependencies with
pnpm i, and runnpm run devfor a local development server. - Create a new article — Run
npx blog nwith a title to generate a new Markdown post file, then edit it in your editor. - Build and deploy — Run
npm run buildto generate the static site, then usenpx blog dto push the latest content to your git remote.
How does Shiina-Astro-Blog work?
The workflow is built around commands: after cloning and installing, you edit content in Markdown/MDX, preview locally with npm run dev, create posts via the CLI, and produce a production build with npm run build. The blog's search and layout are implemented in the theme, and the author notes that some features like image optimization and a sidebar index are either missing or not working well.
Known limitations
The author explicitly lists current drawbacks in the README: image handling is difficult and does not use Astro's built-in image preprocessing, making pages with many images slow to load; the design is not content-focused and the article layout is dense; there is no sidebar article index or image viewer/zoom; and the search uses a custom implementation rather than an integration like Pagefind. Because of these issues, the project is deprecated and the author recommends following the successor project Shiina-Astro-Blog-Next.
FAQ
Is Shiina-Astro-Blog free?
Yes, the project is open source on GitHub, so it is free to use, modify, and deploy. There are no paid tiers mentioned in the repository.
How do I create a new post?
Run npx blog n followed by the title of your article in the project directory. This generates a new Markdown file that you can then edit with your preferred text editor.
Does Shiina-Astro-Blog support image optimization?
No. The README states that the framework does not leverage Astro's native image import and processing, so image-heavy pages can be slow. The author recommends using the upcoming next version for better image handling.
What is the successor project?
The author is developing Shiina-Astro-Blog-Next, a new minimal blog framework that addresses the current version's issues. Progress is available at the linked GitHub repository.
