Astro博客

astro-clearmark-theme — Astro 博客模板

作者 0xqige

ClearMark 是一个基于 Astro 的博客主题，强调内容结构清晰，同时面向人类读者与 AI 抓取工具，内置中英双语、静态搜索与 llms.txt 生成。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

1 个预览视图

作者提供的预览

查看源码在新标签页打开

作者提供的预览

来自项目 README 的原始预览。

目前有 1 张原始预览，可打开完整图片查看设计细节。

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-03查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

构建期生成 llms.txt 与 llms-full.txt，为 AI 爬虫提供结构化内容

内置中英双语支持，采用基于目录的 i18n 路由

Pagefind 静态全文搜索，配合 RSS、sitemap、标签页与归档页

支持 KaTeX 数学公式与带 diff、行高亮的代码块

文章 frontmatter 模型稳定，构建时自动派生阅读时长、字数与摘要

提供明暗模式、响应式布局、TypeScript 与 ESLint/Prettier 配置

模板详细介绍

ClearMark 是一个 Astro 博客主题，定位是让发布的内容在搜索引擎、AI 摘要工具、RSS 阅读器和浏览器中都保持可读、可解析、可引用。它不追求视觉噱头，而是把重点放在语义化 HTML 结构、稳定的 frontmatter 元数据模型，以及构建期生成的 llms.txt / llms-full.txt 上，为 AI 爬虫提供结构化内容。

内容层面，主题提供阅读时长与字数统计、自动摘要、长文自动生成目录、KaTeX 数学公式渲染，以及带 diff 和行高亮的代码高亮。搜索与发现方面使用 Pagefind 做静态全文搜索，并生成 RSS 与 sitemap，另有标签页和归档页。

国际化方面内置中英双语支持和基于目录的 i18n 路由。开发体验上提供明暗模式、响应式布局、TypeScript 覆盖、ESLint 与 Prettier 配置以及 GitHub Actions CI。文章存放在 src/data/blog/ 下，使用 Markdown 编写，frontmatter 支持标题、描述、发布时间、修改时间、置顶、草稿、标签、分类、封面图和社交分享图等字段，构建时派生 minutes、words、excerpt。

主题基于 AstroPaper 二次开发，采用 MIT 许可。README 中列出的技术栈包含 Astro、Tailwind CSS、Pagefind、KaTeX、Satori 和 Sharp，具体版本以仓库依赖清单为准。

Astro博客

适合你的项目吗？

适用场景

搭建以文字内容为主、需要被搜索引擎和 AI 工具正确解析的个人博客
运营中英双语内容站点，希望用目录结构区分语言版本
发布含数学公式或代码示例的技术文章
需要站内静态全文搜索而不引入外部搜索服务的静态站点

适合人群

使用 Astro 并希望快速起步的博客作者
关注内容可被 AI 摘要工具引用与抓取的技术写作者
需要中英双语博客的个人或小团队
偏好 Markdown 写作与静态部署的开发者

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

1
克隆仓库后执行 pnpm install，再用 pnpm run dev 启动本地开发服务器（默认 http://localhost:4321）
2
按顺序修改 src/config.ts（站点名称、描述、作者）、src/constants.ts（社交链接与分享渠道）、src/styles/global.css（颜色与视觉风格）
3
将 src/data/blog/ 中的示例文章替换为自己的 Markdown 内容
4
构建命令 pnpm run build 会执行类型检查、生成 Pagefind 索引与 llms.txt
5
代码采用 MIT 许可，但演示图片、字体、图标等第三方素材需单独核对其许可

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发该版本代码。
分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

https://github.com/0xqige/astro-clearmark-theme/blob/main/LICENSE https://github.com/0xqige/astro-clearmark-theme/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-04。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料一般 · 68 / 100
技术栈: Astro
网站类型: 博客

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2026-03-28
截图检查日期: 2026-10-04

目前没有记录演示链接。请依据仓库说明在本地评估；仅凭截图无法确认交互行为。

目录记录的主要技术栈是 Astro。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

审核声明: [email protected] · 2026-10-05

查看当时使用的来源资料

SHA-256: 52d855b86bfcac4724754501cb0265667c77a3f27402f380dac662c1a71d1d37

2026-10-04T21:10:23.550Z

来源文件 / 仓库

# ClearMark

[![English](https://img.shields.io/badge/lang-English-blue.svg)](./README.md) [![中文](https://img.shields.io/badge/lang-中文-red.svg)](./README_CN.md)

A clean, structured Astro blog theme optimized for **both human readers and AI systems**.

ClearMark focuses on making published content **readable, parseable, and citable** across search engines, AI summarizers, RSS readers, and human browsers — without visual gimmicks.

![ClearMark Preview](./public/clearmark-og.jpg)

## Features

**Content Experience**
- Reading time & word count
- Automatic excerpt generation
- Responsive table of contents (auto-generated for long posts)
- KaTeX math rendering
- Code highlighting with diff / line highlight annotations

**Search & Discovery**
- [Pagefind](https://pagefind.app/) static full-text search
- RSS feed
- Auto-generated sitemap
- Tags & archives pages

**SEO & AI Readability**
- Dynamic OG image generation
- Semantic HTML structure
- Build-time `llms.txt` / `llms-full.txt` generation (structured content for AI crawlers)
- Stable frontmatter metadata model

**Internationalization**
- Built-in Chinese / English bilingual support
- Directory-based i18n routing

**Developer Experience**
- Astro 5 + Tailwind CSS 4
- Light / dark mode
- Responsive layout, mobile-friendly
- Full TypeScript coverage
- ESLint + Prettier
- GitHub Actions CI out of the box

## Quick Start

```bash
git clone https://github.com/0xqige/astro-clearmark-theme.git
cd astro-clearmark-theme
pnpm install
pnpm run dev
```

Dev server runs at `http://localhost:4321`.

## Project Structure

```
clearmark/
├── public/
│   ├── clearmark-og.jpg
│   ├── favicon.svg
│   └── pagefind/
├── src/
│   ├── assets/           # Icons and static assets
│   ├── components/       # Astro / React components
│   ├── data/blog/        # Blog posts (Markdown)
│   ├── i18n/             # i18n configuration
│   ├── layouts/          # Page layouts
│   ├── pages/            # Route pages
│   ├── plugins/          # remark / rehype plugins
│   ├── styles/           # Global styles
│   ├── utils/            # Utility functions
│   ├── config.ts         # Site metadata
│   ├── constants.ts      # Social links & share config
│   └── content.config.ts
└── astro.config.ts
```

## Content Model

Posts live in `src/data/blog/`. Supported frontmatter:

```yaml
---
title: Post Title
description: Summary for cards and SEO
pubDatetime: 2026-03-20T09:00:00Z
modDatetime: 2026-03-20T10:00:00Z  # optional
featured: false                     # optional, pin to homepage
draft: false                        # optional
tags: [astro, blog]                 # optional
category: Guides                    # optional
image: ./cover.png                  # optional, post cover
ogImage: ./social.png               # optional, social share image
---
```

Derived at build time: `minutes`, `words`, `excerpt`.

## Customization Order

1. **`src/config.ts`** — Site name, description, author
2. **`src/constants.ts`** — Social links and share channels
3. **`src/styles/global.css`** — Colors and visual style
4. **`src/data/blog/`** — Replace with your own posts

## Commands

| Command | Description |
|---------|-------------|
| `pnpm run dev` | Start dev server |
| `pnpm run build` | Production build (type check + Pagefind index + llms.txt) |
| `pnpm run preview` | Preview build output |
| `pnpm run lint` | ESLint check |
| `pnpm run format:check` | Prettier format check |
| `pnpm run format` | Auto-format |

## Tech Stack

- [Astro](https://astro.build/) 5 — Static site framework
- [Tailwind CSS](https://tailwindcss.com/) 4 — Utility-first CSS
- [Pagefind](https://pagefind.app/) — Static full-text search
- [KaTeX](https://katex.org/) — Math rendering
- [Satori](https://github.com/vercel/satori) — OG image generation
- [Sharp](https://sharp.pixelplumbing.com/) — Image processing

## Credits

ClearMark is derived from [AstroPaper](https://github.com/satnaing/astro-paper) by Sat Naing (MIT License). See [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md).

## License

MIT

反馈内容错误