Astro Spaceship is a powerful, minimal, and flexible theme designed for turning your Obsidian vault into a beautiful, static website using Astro and TailwindCSS. Whether you’re sharing your digital garden, notes, or a Zettelkasten, this theme helps bring your knowledge to the web with elegance and ease.

✨ Features

  • 🔗 Obsidian Link and Image Resolution
    Seamlessly supports wiki-links and image embeds, just like in Obsidian. No need to manually convert links or media.

  • 📝 Frontmatter Metadata for Publishing
    Control visibility, titles, descriptions, tags, and more with simple frontmatter options. Choose what gets published and how it appears.

  • 🌲 Tree Navigation Bar
    Navigate your notes with a collapsible file tree that mirrors your vault structure. Makes exploring content intuitive and fast.

  • 🗂 Table of Contents (ToC)
    Auto-generated ToC for every page, based on headings in your notes. Helps readers easily jump to sections.

  • 🔁 Links and Backlinks
    Display outgoing links and backlinks at the bottom of each note, making your web of notes as interconnected as your vault.

🚀 Built With

  • Astro – Lightning-fast static site generation.
  • TailwindCSS – Utility-first CSS for rapid UI styling.
  • Markdown – Your content stays in plain text, easy to version and manage.

📁 Use Cases

  • Publish a second brain or digital garden
  • Share your research notes and knowledge base
  • Create a personal wiki
  • Document creative projects or coursework

📸 Screenshots

001.jpg 002.jpg 003.jpg 004.jpg

🛠 Setup & Usage

  1. Start a new project with create astro or just clone this repo.
npm create astro@latest -- --template aitorllj93/astro-theme-spaceship
  1. Drop your Obsidian vault into the content/ folder.
  2. Customize your config (navigation, theme colors, etc.)
  3. Run npm install && npm run dev to get started!

Customization

  • website.config.mjs: Global settings such as the Website name and default author
  • styles/global.css: Tailwind CSS configuration
  • content.config.ts: Your collections config, including the Obsidian one. Be careful while applying changes here.
  • content: Your Obsidian Vault + some metadata collections: Authors and Tags

🧠 Notes

  • Internal links work only for files within the vault structure.
  • Uses YAML frontmatter for publishing logic.
  • Markdown rendering includes code highlighting, math support (optional), and responsive design out-of-the-box.

🧪 Future Improvements

  • Search functionality
  • Dark mode toggle
  • Custom plugin support
  • Tag pages and graph view
  • Configuration script

📄 License

MIT – Free to use, modify, and share.

Examples

Here are some examples to get started with:

Cheatsheets

Templates