Skip to main content
HeyBear HuB
Obsidian logo with a black background.

Installing Obsidian

Optional Software • Version 1.0.0 •

This guide shows you how to install Obsidian for use with your Astro Modular blog, enabling a fast and local-first writing experience.

Download Obsidian

  1. Go to obsidian.md
  2. Click the Download button.
  3. Choose your operating system (Windows, macOS, or Linux).

Install

Windows

  1. Run the downloaded .exe installer.
  2. Follow the quick installation wizard.
  3. Launch the Obsidian application.

macOS

  1. Open the downloaded .dmg file.
  2. Drag the Obsidian icon into your Applications folder.
  3. Launch Obsidian from your Applications.

Linux

  1. Extract the downloaded .AppImage file.
  2. Make the file executable: chmod +x Obsidian-*.AppImage
  3. Run the executable in your terminal: ./Obsidian-*.AppImage

Why Use Obsidian as a CMS?

Unlike traditional blogging platforms that host your content in complex online databases, Obsidian stores your vault as plain text local Markdown files on your computer. This local-first philosophy offers several key benefits for bloggers:

  • Speed: Searching, writing, and organizing notes happens instantly on your hard drive.
  • Control: Your content is never locked into a proprietary system. You own your text files.
  • Offline Access: You can draft, edit, and reorganize posts even when you have no internet connection.

First Launch and Vault Setup

  1. Open Obsidian.
  2. Under “Open folder as vault”, click Open.
  3. Select your blog’s src/content/ directory within your cloned project folder.
  4. Click Select Folder to open it.
  5. Trust the vault settings to load the community plugins that come preconfigured with this template.

Once Obsidian is installed and your vault is open, you can:

  • Write blog posts in standard markdown.
  • Use wikilinks [[Like This]] for seamless internal linking.
  • Add local images and other media assets.
  • Publish directly to your Astro blog using the pre-configured Git sync shortcut (Ctrl + Shift + S).

That’s it! You’re ready to start writing.