Astro Composer for Obsidian

Turn your Obsidian notes into posts and pages for your Astro blog with automated content management features.

Made for Vault CMS

Part of the Vault CMS project.

Video Guide

📺 Astro Composer Plugin for Obsidian Video Guide

Features

• New Post Dialog: When enabled, prompts for a title when creating a new Markdown file via Obsidian's "New note" action, auto-generating a kebab-case filename (e.g., "My Blog Post" → my-blog-post.md) and optionally inserting properties with title, date, etc.
• MDX Support: Full .mdx file support including file creation (per content type via the useMdxExtension setting), link conversion, and property standardization.
• Property Standardization: Updates a note's properties to match a customizable template using the "Standardize Properties" command. Preserves existing property values, adds missing properties from the template in the specified order, and appends unrecognized properties at the end.
• Draft Management: Optionally adds an underscore prefix (e.g., _my-post.md) to hide drafts from Astro, configurable via settings.
• Internal Link Conversion: Converts Obsidian wikilinks and markdown internal links ([[My Post]] or [My Post](my-post)) to Astro-friendly Markdown links ([My Post](/blog/my-post/)), supporting both file-based and folder-based post structures.
• Configurable Workflow: Customize posts folder, link base path, creation mode (file-based or folder-based with index.md), date format, and excluded directories. Enable or disable automation for new notes and properties insertion independently.
• Robust Automation: Only triggers the title dialog for user-initiated new notes (e.g., via "New note" command), avoiding unwanted prompts during vault loading or file imports (e.g., via git pull).
• Rename Post Command: easily rename your notes by updating the title property with the desired post name, and get a kebab-case file or folder update afterward.

Installation

Astro Composer is not yet available in the Community plugins section. Install using BRAT or manually:

BRAT

1. Download the Beta Reviewers Auto-update Tester (BRAT) plugin from the Obsidian community plugins directory and enable it.
2. In the BRAT plugin settings, select Add beta plugin.
3. Paste the following: https://github.com/davidvkimball/obsidian-astro-composer and select Add plugin.

Manual

1. Download the latest release from the Releases page and navigate to your Obsidian vault's .obsidian/plugins/ directory.
2. Create a new folder called astro-composer and ensure manifest.json, main.js, and styles.css are in there.
3. In Obsidian, go to Settings > Community plugins (enable it if you haven't already) and then enable "Astro Composer."

Usage

1. Customize Settings: In Settings > Astro Composer, configure:
   • Automate post creation: Toggle to enable the title dialog for new files created via Obsidian's "New note" action (ensure your default new note location matches your post location in Obsidian settings). Each content type can be configured to create .mdx files instead of .md via the useMdxExtension setting.
   • Auto-insert properties: Enable to automatically apply the properties template when creating new files (requires "Automate post creation" to be enabled).
   • Posts folder: Set the folder for blog posts (leave blank to use the vault root). Specify the default location for new notes in Obsidian's Settings > Files and links.
   • Ignore subfolders: Restrict automation to the specified posts folder and its subfolders.
   • Excluded directories: List directories to exclude from automation (e.g., pages|posts/example), separated by |, when not restricted to the posts folder.
   • Use underscore prefix for drafts: Add a prefix (e.g., _my-post.md) to hide drafts from Astro.
   • Creation mode: Choose file-based (my-post.md) or folder-based (my-post/index.md) structure.
   • Index file name: Name the main file in folder-based mode (e.g., index).
   • Date format: Set the properties date format (e.g., YYYY-MM-DD or MMMM D, YYYY).
   • Properties template: Define the template for new posts and standardization. Supports {{title}}, {{date}}, and {{slug}} placeholders (e.g., ---\ntitle: "{{title}}"\ndate: {{date}}\nslug: {{slug}}\ndescription: ""\ntags: []\n---).
2. Enable More Content Type Automation: With "Enable pages" enabled and by creating custom content types, you can do the same automation behavior for any other content type, like pages, documentation, projects, etc. Wildcard patterns are supported: use * in folder paths to match any folder name (e.g., docs/* matches docs/anything/, docs/*/* matches docs/anything/anything/). This allows you to create separate content types for different folder depths.
3. Standardize Properties: Use the Astro Composer: Standardize Properties command to update a note's properties to the relevant content type, preserving existing values, adding missing properties, and maintaining the template's order with unrecognized properties at the end.
4. Convert Internal Links: Use the Astro Composer: Convert internal links for Astro command to transform Obsidian wikilinks and internal Markdown links into Astro-compatible Markdown links.
5. Rename Content: Using the Astro Composer: Rename Current Note command, set the title of your content and have the file or parent folder get automatically renamed with the kebab-case version.

Contributing

Submit issues or pull requests on the GitHub repository. Contributions to enhance features, improve documentation, or fix bugs are welcome!