Markdown

Markdown is a first-class citizen in Blog CMS. If you think in plain text, you can write entire posts in Markdown mode — complete with syntax highlighting — and switch back to the visual editor any time.

Why Markdown

Markdown keeps your hands on the keyboard and your formatting predictable. It's ideal for technical posts, fast drafting, and anyone who already writes Markdown in their day-to-day tools.

The basics

A few essentials you'll use constantly:

• Headings with ## and ###.
• Lists with - for bullets and 1. for numbers.
• bold and italic for emphasis.
• Inline code wrapped in single backticks.
• Links written as text in square brackets followed by the URL in parentheses.

Code blocks

For longer snippets, use fenced code blocks — three backticks, an optional language name, your code, then three closing backticks. Blog CMS applies syntax highlighting based on the language you specify, so technical posts read clearly. This pairs well with the editor's inline code for short references.

Importing .md files

Already have content in Markdown? You can import a .md file directly. This is handy when you're migrating posts from another tool, drafting in your own editor, or moving documentation into your blog. The import preserves headings, lists, code blocks, and other standard Markdown structure.

Switching modes

Markdown mode and the WYSIWYG editor operate on the same post. Write a draft in Markdown, then switch to the visual editor to drop in an image or table from Images and media, then switch back. Nothing is lost in translation.

Tips

• Keep a blank line between block elements (paragraphs, lists, headings) so they render correctly.
• Always tag code blocks with a language to get the best highlighting.
• Use reference-style structure: a short intro, then sections under ## headings.
• When in doubt about how something will look, preview it in WYSIWYG mode.

What renders where

Your Markdown becomes clean, semantic HTML when you deploy, styled by your chosen theme. That means the same post looks consistent with the rest of your site without you fiddling with markup.

Ready to publish what you've written? Head to Deploying your blog. For help with Markdown import, email [email protected].