🌌 Spaceship

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

🛠 Setup & Usage

1. Start a new project with create astro or just clone this repo.

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

2. Drop your Obsidian vault into the content/ folder.
3. Customize your config (navigation, theme colors, etc.)
4. 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

• Markdown Cheatsheet

Templates

• Blogging Lorem Ipsum