Markdown On WordPress.com

November 19th, 2013

The folks at WordPress.com have great news for fans of Markdown. It’s now built-in by default to every WordPress.com blog, and it’s super-easy to enable:

To start using Markdown, go to Settings → Writing in your blog dashboard, check the box next to Use Markdown for posts and pages, and save.

I just enabled it for one of my test blogs and am happy to report that MarsEdit works perfectly for publishing with Markdown to WordPress.com. They mention that it’s best to stick to the “plain text” editor on WordPress.com, and the same is true for MarsEdit. You’ll want to stick with editing in “HTML Text” mode so the plain Markdown text can get to your blog without being wrapped in HTML generated by MarsEdit’s rich editor.

I wrote recently about MarsEdit’s ability to automatically convert Markdown to HTML before publishing a post. It’s worth noting that if you use the new Markdown functionality on WordPress, you probably want to avoid MarsEdit converting to HTML. This is because WordPress’s implementation of the Markdown feature does things “the right way” in my opinion, storing the original Markdown as the text of the post, so you can make further edits to the post by editing the original Markdown and not the converted HTML.

The only downside I’ve noticed so far is that when you download a post through the API from MarsEdit or from the official WordPress apps, the content is converted to HTML even though it shouldn’t be. The original Markdown does show up in the web-based WordPress admin panel. I’m going to report this as a bug and hopefully they will agree that it should be fixed.

3 Responses to “Markdown On WordPress.com”

  1. Aaron Benedict Says:

    What version of WordPress is that for? I’m currently running 3.7.1 and I don’t see that option anywhere in the Writing section.

  2. Daniel Jalkut Says:

    Aaron – I should have been more clear that this only affects WordPress.com, the hosted site run by Automattic.

    WordPress.com uses the baseline WordPress.org software but extends it with extra features. However, recently they have been sharing a large number of those extra features with their Jetpack plugin for WordPress.org sites. Maybe this new Markdown support will show up in there!

  3. Aaron Benedict Says:

    Thanks Daniel, that makes more sense. I do expect that Jetpack will have it in their plug-in one of these days. In the meantime, I’m quite happy to use the workflow set up in your previous blog post.

Comments are closed.

Follow the Conversation

Stay up-to-date by subscribing to the Comments RSS Feed for this entry.