Installation

To install this Micro.publish, open Obsidian and go to Settings > Community Plugins > Browse. Search for Micro.publish and click Install. Alternately, it can be installed directly from Obsidian’s website.

Login

After installing Micro.publish, you need to log in to a Micro.blog account with an App Token. You can create an App Token on the Micro.blog Account Page.

Settings

Users with multiple blogs can set a default blog, default categories, and default post visibility (draft or public). These settings can be overridden before publishing a note to Micro.blog.

Publishing

The plugin has three commands that can be accessed through the Command Palette:

  • Publish Post to Micro.blog - This command publishes the selected note to Micro.blog as a blog post.
  • Publish Page to Micro.blog - This command publishes the selected note to Micro.blog as a page.
  • Synchronize Categories - This command fetches all the categories used in your blog from Micro.blog.

Tip: Micro.publish automatically fetches categories from Micro.blog whenever Obsidian is launched.

Before publishing a note to Micro.blog as a post, Micro.publish opens a window that allows you to change the post title, tags, visibility, and data (for scheduling a post for a future date). For pages, it’s possible to override the title and define if the the page should be included in the blog navigation or not.

Properties

Micro.publish supports YAML frontmatter. It also works with the new Properties feature introduced in Obsidian 1.4, which is essentially a user-friendly interface for the less aesthetically pleasing YAML syntax.

  • Micro.publish will use the title property in the frontmatter or Properties, if it exists. Otherwise, it will fall back to the filename.
  • Micro.publish will use the tags property in the frontmatter or Properties, if it exists. Otherwise, it will use the default categories configured in Micro.publish’s preferences.

Editing

For notes published with version 2.0.0 or newer, the post’s - or page’s - URL will be added to the Markdown file in the YAML frontmatter/Property.

For those in Edit mode, it appears as a Property as shown below:

And for those utilizing the Source mode, as YAML:

Once the note has been edited or title has been changed (either through the filename or YAML/Property), updating is as simple as using the Publish Post to Micro.blog or the Publish Page to Micro.blog commands from the Command Palette. A simplified version of the Review view will appear, displaying the note’s title. For users with multiple blogs, it will prompt them to confirm which blog the post or page belongs to.

It is also possible to update posts and pages that were published using Micro.publish versions prior to 2.0.0. To do so, you must include a Property (or field in the YAML frontmatter) named url containing the URL of the published post or page, as illustrated below.

To include a new Property, simply follow these steps in the Command Palette:

And add the url with the published post post page URL:

Those who prefer the YAML file can add the the url using the format:

---
url: https://example.com/path/to/post.html
---

After editing the content of the note or its title (either through the filename or YAML/Property), updating is as straightforward as utilizing the Publish… commands from the Command Palette. Similar to the process for version 2.0.0, a simplified version of the Review view will be presented, featuring the note’s title. For users with multiple blogs, it will inquire about the blog to which the publication should be associated.