How To Publish From Obsidian To WordPress In 6 Easy Steps

Table of Contents

You use Obsidian already, so I do not have to tell you why it’s an excellent app for writing.

Now you might also want to use it for blogging with WordPress.

Here is an easy setup that works for me:

Video Version of this post:

Create a New WordPress User Account

Create a new WordPress user in your dashboard.
Why? The account name and details will be added in Obsidian to connect to your WordPress site. For nothing else.

Add this user with the role “Author”
Choose a username and a password.

Remember it :)

You can also use your existing user account, but I recommend creating a new one for that specific use case. You can change the user of the post before clicking publish in WordPress.

Install and configure an authentication plugin

Note: This step is necessary because, typically, a WordPress site does not allow connections from outside (anymore) by default. But you can try first if that also applies to your site – go to the next step and install the WordPress plugin in Obsidian and see if you can connect. But again, I would, in any case, suggest doing it with a separate user.

Install the WordPress REST API Authentication.
You need this plugin to make your WordPress site ready to accept connections from other apps, like Obsidian.

Install and activate the plugin.

There are many plugins for this job. This one works well for us.

Now configure the basic authentication method.

Follow the steps in the screenshots:

Select Basic Authentication

Select the Username & Password with Base64 Encoding option
Add the details of the user you just created in step 1.

Test the configuration.

Now your WordPress site is configured for connections via external apps like Obsidian.

In Obsidian: Install the WordPress Plugin

Obsidian does not support publishing to WordPress out of the box. But thanks to a community plugin, you can add that functionality.

Click on Settings > Community Plugins > Browse.

Then search for WordPress and install the “WordPress Publish” plugin.

After the install finished, click Enable.

  • Technical information about the plugin on GitHub

Configure WordPress Publish Plugin

Now, with the WordPress Publish plugin installed and enabled, you have to add the details of your WordPress site.

Again, in Obsidian settings, click the WordPress icon.

On this screen, you add the URL of your website, choose REST API in the dropdown, and I recommend to show the icon of the plugin in the sidebar.

After that is done, the icon should show up in the top left corner.
If not, close and restart Obsidian.

Click Login.

Now you can add the newly created account details in the following screen.

Add the user name, password, and I recommend publishing only the draft to WordPress.

Continue editing in WordPress

After you published a note from Obsidian to WordPress, you can continue editing there.
Here is one important thing to note: This p lugin creates “Classic” editor component in your post. You might want to convert it to “blocks” editing.

Apart from that, you want to change the author, add tags, categories, the permalink, a featured image, and much more – those are all things you can’t do inside Obsidian.

Hit publish

That’s it! You successfully drafted a blog post in Obsidian, published it to WordPress.

Other things to note

Publishing images to WordPress from Obsidian

It does not transfer your images that are embedded in Obsidian. I use Obsidian to write my drafts and continue editing in WordPress. I only add images in WordPress.

You can’t see your edits from WordPress in Obsidian

Every time you publish a note from Obsidian to WordPress, a new post is created in WordPress.

So I recommend you only publish from Obsidian to WordPress when you are nearly finished and continue editing your post in WordPress.

Conclusion

For bloggers that write text-heavy blog posts, this is a good recipe. Obsidian gives you a distraction-free writing experience.

This community plugin is very basic from a feature perspective; it would be nice to have image support and that it creates already blocks instead of the classic editor widget.

I am happy it is available and has been reliable so far. I wrote about ten posts that way (including this one) – no problems so far.

Get Access To Our List of 185 Tested Apps!

All you have to do is join our newsletter.

Every two weeks you will get an email with 4-5 recommended apps, plus reading tips.

Our newsletter is for marketing nerds, online creators of all kind, and entrepreneurs. up!

8 Responses

  1. You didn’t mention that you have to have a Creator level account (at $40/month) to be able to add plugins to your wordpress account. I just dont’ think being able to post blog entries on wordpress is worth $480/year. Especially without the ability to take the entire entry you’ve authored in Obsidian and post it to wordpress.
    Having said all that, your tutorial is very well done and I appreciate the work you put into it. Thank you for sharing your knowledge with us.

    1. I think something to consider would be “self hosting” a wordpress site… so that means you can either use an old computer in your house and create a web server or buy a shared hosting account and setup wordpress that way. No reason to pay the sort of money your talking about… yea that’s nuts.

      Let me know if you want help setting this up, I got your back brothaman…

    2. Hi Mike, it seems you are with WordPress.com. I agree, that is way too expensive. My tutorial is meant for people who self-host WordPress (installing and maintaining WordPress with their hosting company of choice). But I see many benefits of using WordPress com – you do not have to worry about security, backups, etc..

  2. This is really impressive! THANK YOU.

    I recently discovered this and gave it a try; it functions smoothly without any issues. Initially, I opted for the standard authentication method using XML-RPC with a username and password to avoid adding another plugin. Later, I decided to experiment with the REST API Auth using an application password. I navigated to my profile, scrolled to the bottom, generated an application password, and used it.

    Is there a distinction between the built-in self-hosted WordPress.org configuration found at /wp-admin/profile.php under “Application Passwords” and the WordPress REST API Authentication offered by miniOrange?

    I was also thinking maybe I could “edit” my initially published (not draft) post but I don’t think that’s possible… all good. Basically, I can blast away drafts, publish them than log into wordpress and make finishing touches with seo plugins, etc and call it a day.

    1. Hi, excellent point. It is way easier to use WordPress’s built-in XML-RPC feature, you can skip the plugin install part. What I discovered in recent years is that many hosting companies are not allowing that connection, thus, a 3rd party plugin is needed to make the authentication/data transfer possible.

      For anyone curious: WordPress has XML-RPC support. That means, in simple terms, external tools can connect and publish via that on your site. More about it here: https://codex.wordpress.org/XML-RPC_Support

  3. Is there a way to handle markdown conversion automatically? Specifically, I’m wondering about Obsidian links to other notes, and automatically converting [[ ]] to the links to other blog posts.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Curation & Analysis

Join 1600 B2B Creators who get our bi-weekly curated newsletter.

Hand-picked content & apps across social, tech, AI, productivity!