Back to themes

Spaceship

Publish your Obsidian vault as a fast, elegant website using Astro and TailwindCSS. Supports Obsidian-style links, image embeds, tree navigation, backlinks, and more—perfect for digital gardens and personal wikis.


Cost

Free


Created by
Aitor

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 embeds like ![[image.png]], 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


🛠 Setup & Usage

npm create astro@latest -- --template aitorllj93/astro-theme-spaceship

🧠 Notes

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

🧪 Future Improvements

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

📄 License

MIT – Free to use, modify, and share.