To convert Markdown blog posts to WordPress, follow this step-by-step guide using simple tools and methods:
1. Understand the Formats
-
Markdown: A lightweight markup language using plain text formatting.
-
WordPress: Accepts posts via its Classic Editor, Block Editor (Gutenberg), or programmatically via XML-RPC or the REST API.
2. Use a Markdown to WordPress Plugin (Best Option)
Option A: WP Githuber MD
-
Features: Write posts in Markdown, renders to HTML automatically.
-
Steps:
-
Install WP Githuber MD from WordPress Plugins.
-
Activate the plugin.
-
Add or edit a post, and write or paste your Markdown directly.
-
It auto-converts Markdown to HTML for display.
-
Option B: Jetpack + Markdown Module
-
Steps:
-
Install Jetpack plugin.
-
Enable Markdown support under Jetpack settings.
-
Paste Markdown content directly into the post editor.
-
3. Convert Markdown to HTML (Manual Method)
If you prefer not to use a plugin:
Step-by-Step:
-
Use an online Markdown-to-HTML converter like markdowntohtml.com.
-
Paste your Markdown content.
-
Copy the generated HTML.
-
In WordPress:
-
Open the post editor.
-
Switch to Text/HTML view (Classic Editor) or add a Custom HTML block (Block Editor).
-
Paste the HTML content.
-
4. Use Markdown Editors with WordPress Integration
Option: Typora + WordPress
-
Write in Markdown using Typora.
-
Export your post as HTML.
-
Paste that into WordPress as described above.
Option: Obsidian + Export Plugin
-
Write in Obsidian.
-
Use the “Markdown Export” community plugin to export as HTML.
-
Upload or paste into WordPress.
5. Automated Bulk Import (Advanced Users)
If you have many Markdown posts:
Use WordPress REST API or WP All Import Plugin:
-
Convert Markdown to HTML using a script (e.g., Node.js +
marked
). -
Use a tool like WP All Import:
-
Prepare a CSV/XML file with post title, content (converted HTML), categories, etc.
-
Map the fields during import.
-
Alternatively: Use Static Site Generators like Hugo/Jekyll with WordPress
-
Export Markdown content to HTML.
-
Use WP Importer Tool to import the static site.
6. Fix Formatting After Import
Post-conversion tips:
-
Check headings, images, and links.
-
Adjust for WordPress theme compatibility.
-
Use SEO plugins (like Yoast) to optimize each post.
7. Preserve Metadata
If your Markdown files include front matter (e.g., title
, date
, tags
):
-
Extract metadata manually or using scripts.
-
Add corresponding data in WordPress manually or via import tools.
Summary Workflow
Task | Method |
---|---|
Single post import | Use plugin or manual HTML |
Bulk import | Convert to HTML > WP All Import |
Retain Markdown formatting | WP Githuber MD or Jetpack |
Best for non-tech users | WP Markdown plugin |
Best for developers | REST API + Markdown-to-HTML scripts |
This process ensures smooth conversion of your Markdown content into fully formatted WordPress posts, maintaining both structure and SEO integrity.
Leave a Reply