Astro Modular
Astro Modular is a free, open-source Astro theme built specifically for Obsidian users. It includes a dedicated settings plugin so you can configure your site from inside Obsidian.
Features
Section titled “Features”Site Features
Section titled “Site Features”- 17 built-in color themes + custom theme generation
- Command palette (Ctrl+K) for search, navigation, and quick actions
- Page transitions (Swup.js)
- Local knowledge graph with D3
- Linked mentions (backlinks)
- Profile card with customizable placement
- Automatic OG image generation
- RSS feed and sitemap
- Multiple deployment platform configs (Netlify, Vercel, Cloudflare, GitHub Pages)
Content Types
Section titled “Content Types”- Posts with tags, cover images, reading time, word count, and drafts
- Pages for static content
- Projects with status badges and links
- Docs with category grouping
Writing Features
Section titled “Writing Features”- Full Obsidian markdown parity: wikilinks, callouts, highlights, embeds, image sizing
- LaTeX/KaTeX math rendering
- Mermaid diagrams
- Image grids with lightbox
- Code blocks with syntax highlighting
- Giscus comments (optional)
Astro Modular Settings Plugin
Section titled “Astro Modular Settings Plugin”- Dedicated Obsidian plugin that controls all site configuration
- Theme switching, typography, layout, and feature toggles from a UI
- Custom theme generation (extract colors from your Obsidian theme)
- No config.ts editing required
Getting Started
Section titled “Getting Started”- Clone or download the Astro Modular repo
- Open the
src/contentfolder as a vault in Obsidian - Vault CMS and the settings plugin are already bundled
- Start writing
Frontmatter Properties
Section titled “Frontmatter Properties”| Property | Type | Description |
|---|---|---|
| title | string | Post title |
| description | string | Short description for SEO and previews |
| date | date | Publication date |
| tags | string[] | Tags for categorization |
| draft | boolean | Hide from production builds |
| image | string | Cover image path |
| imageAlt | string | Cover image alt text |
| imageOG | boolean | Use cover image as OG image |
| hideCoverImage | boolean | Hide cover image on the post page |
| hideTOC | boolean | Hide table of contents |
| targetKeyword | string | SEO target keyword |
License
Section titled “License”MIT. Free for personal and commercial use.