Aonote is a clean, typography-focused static blog theme for Astro 6.
Write in Markdown. Ship fast static HTML. No React, Vue, or Tailwind required.
Who it’s for
Personal blogs — notes, projects, reading lists, long-form posts
Technical writing — code walkthroughs, snippets, tool configs
Lightweight docs — changelogs, guides, design decisions
Teams already on Astro who want Aonote’s typography and Markdown extensions without the upstream Python toolchain
What you get
Pages & navigation
Home (post list), single post layout, archive (by year), tags index & tag pages
About page and custom 404
Mobile-friendly header nav and in-page table of contents
Markdown & content
GitHub Flavored Markdown: tables, task lists, footnotes, definition lists
Admonitions (tip, note, warning, danger)
MathML math via temml — no KaTeX runtime CSS bundle
Shiki code blocks with file titles, line highlights, and diff markers
Astro Content Collections for posts and pages
SEO & syndication
RSS and Atom feeds
XML sitemap (`@astrojs/sitemap`)
Canonical URLs, Open Graph, and Twitter cards
Theme & i18n
Light and dark mode (follows `prefers-color-scheme`)
UI strings in English or zh-CN via `src/i18n.ts`
Subpath-aware links when deployed under a GitHub Pages repo path (`repoSubpath`)
