A minimalist, bilingual blog template built with Astro 6, React 19, and Tailwind CSS 4.

Keywords: Astro blog template, bilingual blog, static site generator, Pagefind search, Tailwind CSS 4, React blog, SEO blog starter, Chinese English i18n blog.

• Bilingual — English and Chinese with automatic language detection
• Dark mode — Light/dark theme with user preference memory
• Full-text search — Static search powered by Pagefind
• Mermaid diagrams — Hand-drawn style by default
• Math rendering — LaTeX via KaTeX
• Comments — Giscus (GitHub Discussions) integration
• RSS feeds — Separate feeds for each language
• Image lightbox — Click-to-zoom with thumbnail gallery
• SEO optimized — JSON-LD structured data, sitemap, robots.txt
• Reading time — Automatic estimation per article
• Table of contents — Active section tracking on article pages
• Optimized fonts — Inter, Noto Sans SC, JetBrains Mono via Astro Fonts API

# Clone the template
git clone https://github.com/OldJii/ink-blog.git my-blog
cd my-blog

# Install dependencies
npm install

# Start dev server
npm run dev

Open http://localhost:4321 to see your blog.

Edit site.config.ts to customize your blog:

export default defineSiteConfig({
  site: 'https://your-blog.com',
  title: 'My Blog',
  description: 'A minimal blog',
  avatar: '/avatar.png',
  theme: { mode: 'light', enableUserChange: true },
  socialLinks: [
    { icon: 'github', link: 'https://github.com/your-username' },
  ],
  // See site.config.ts for all options
});

Add Markdown files to src/content/post/en/ (English) and src/content/post/zh/ (Chinese):

---
title: My First Post
description: A brief description
tags:
  - Tech
  - Life
pubDate: 2026-01-01
draft: false
contentWidth: medium  # optional: narrow, medium, wide, full
---

Your article content here...

Static pages go in src/content/pages/. The About page uses about.md (Chinese) and about-en.md (English).

• Standard Markdown (headings, lists, tables, images, code blocks)
• LaTeX math: $inline$ and $$block$$
• Mermaid diagrams in fenced code blocks
• Container blocks: :::tip, :::warning
• GitHub emoji: :rocket: → 🚀

├── plugins/              # Remark plugins
├── public/               # Static assets
├── src/
│   ├── assets/           # Styles
│   ├── components/       # UI components
│   ├── content/
│   │   ├── pages/        # Static pages
│   │   └── post/
│   │       ├── en/       # English articles
│   │       └── zh/       # Chinese articles
│   ├── helpers/          # Utilities
│   ├── i18n/             # Translation strings
│   ├── pages/            # Route pages
│   └── typings/          # Type definitions
├── astro.config.mjs
├── site.config.ts       # Site configuration
└── tsconfig.json

1. Push to GitHub
2. Import in Vercel
3. Deploy — zero configuration needed

The build output is a static site in dist/. Deploy it to any static hosting (Netlify, Cloudflare Pages, GitHub Pages, etc.).

Design inspired by slate-blog.

What is Ink Blog?
A free, open-source Astro blog template with English/Chinese support, dark mode, search, Mermaid, KaTeX, comments, and built-in SEO (JSON-LD, sitemap, Open Graph).

Who is it for?
Developers and writers who want a fast static blog without a CMS — customize via site.config.ts and Markdown files.

Does it support Chinese content?
Yes. Put English posts in src/content/post/en/ and Chinese posts in src/content/post/zh/; UI strings are in src/i18n/.

How do I deploy?
Run npm run build and upload dist/, or connect the repo to Vercel for zero-config deploy.

Is Ink Blog good for SEO and AI discoverability?
Yes — JSON-LD structured data, sitemap, RSS, semantic HTML, and llms.txt for LLM/answer-engine crawlers.

Where can AI assistants read a structured summary?
See llms.txt (repo root) and public/llms.txt (served on your deployed site).

MIT