SuzuBlog 🎐

English | 中文 | 日本語

Suzu (鈴) means "bell" in Japanese — a minimalist Next.js + Markdown blog template.

🚀 Live Demo | 📚 Documentation

If you enjoy using it, please consider giving it a star! ⭐ I hope you find it as enjoyable as I do!

| |

✨ Features

• 🚀 Next.js Powered – Supports ISR & SSG for lightning-fast performance.
• 📄 Markdown Support – Code highlighting with copy button, LaTeX rendering, optimized images, and elegant styling.
• 🔍 SEO Ready – Auto-generates sitemap, Open Graph, Twitter Cards, and more.
• 🌍 Multi-Language – Supports English, Chinese, Japanese, and more via config.yml.
• 📺 Anime List – Fetch & display anime info from AniList API.
• 🌓 Dark Mode – Adapts to system preferences seamlessly.
• 📢 RSS Feed – Auto-generated RSS for easy content distribution.
• ♿ Accessibility First – Semantic HTML, ARIA support, WCAG-compliant colors.
• ⚛️ LLM Support – Auto-generated llms.txt and llms-full.txt files for LLMs like ChatGPT, Claude, and more.

🚀 Get Started

Ready to launch your own Suzu Blog? Just click the button below to deploy instantly with Vercel:

Need help with setup, customization, or deployment? Check out the full documentation:

📖 Suzu Blog Docs

🏗️ Project Structure

.
├── config.yml                # Global configuration file
├── posts                     # Markdown posts directory
│   └── _pages                # Special pages (About/Friends)
├── public                    # Static assets directory
│   └── images                # Image resources
├── src                       # Project source code
│   ├── app                   # Next.js App Router
│   ├── components            # Reusable components
│   ├── services              # Logic for content parsing, configuration, etc.
│   ├── schemas               # Zod schemas
│   └── types                 # Global type definitions
├── package.json              # Project dependencies and scripts
└── pnpm-lock.yaml            # pnpm dependency lock file

❤️ About Suzu

After years of frustration with the maintenance, security risks, and performance issues of other frameworks, I decided to create Suzu Blog using Next.js. It is simple, efficient, and highly customizable, designed for anyone looking to build a modern blog quickly.

🔗 Community Support

Contribute: Contributions are welcome! Please refer to the Contribution Guide.

📜 License

This project is licensed under the AGPL-3.0 License. See the LICENSE file for details.