The Capiche Markdown guide.

Markdown is the most popular way to format plain text.

Add common characters like asterisks and dashes to text, much like how you might format a quick store list in your notes app or add emphasis to a word in a text message, to structure and style your writing with Markdown. It’s more universal than rich text formatting (which depends on the program you’re using), easier to read than HTML.

Here’s how.

Mostly, write as normal. Most text doesn’t need formatting; type your words and sentences as you would anywhere. Press Return twice after paragraphs to make sure there’s a blank line between them, otherwise there’s nothing else to think about.

When you need to format text, the core things to remember are to add hash signs before text for headers, single underscores around text for italics, double underscores for bold, and brackets+parenthesis for links. Here are the core markdown formatting options to remember:

  • Italics: Add a single underscore or asterisk before and after the text, like _this_ or *this*.
  • Bold: Add two underscores or asterisks before and after the text, like __this__ or **this**.
  • Bold and Italics: Add three underscores or asterisks such as ***this***.
  • Code: Add a backtick before and after the text like `this`. Or, to add full lines of code, indent the text with a tab or four spaces.
  • Link: Add a square bracket before and after the linked text, then add the link wrapped in parenthesis like [this](
  • Image: On a new line, add an exclamation mark followed by square brackets with the alt text inside, followed by the link to the image wrapped in parenthesis like ![this](
  • Quote: Add the quoted text on its own line, then put a greater than symbol before the text like > this.
  • Header: On a new line, add a single hash or pound sign before the header text for an H1 header like # This; use 2 hash signs for H2, 3 for H3, and so on.
  • Line break: On a new line, add three asterisks like this ***.
  • Unordered lists: Put each list item on its own line and add a dash and space before each item like - this.
  • Ordered lists: Put each list item on its own line and add the correct order number and a space before each item like 1. this.

That’s the basics. For more advanced Markdown formatting, check John Gruber’s original Markdown documentation for more examples. And for fun, here's the story behind markdown, and how it was inspired by early email formatting.

NBNite's avatar
a year ago

Super helpful guide.. thanks for sharing!

2 points
emre's avatar
a year ago

I learned one more thing, thanks.

2 points
Livenadav's avatar
a year ago

Can I write my essay on Notion, export to Markdown format (.MD) and upload it here in Capiche?

1 point
maguay's avatar
@maguay (replying to @Livenadav )
a year ago

The best way is to write in an app that lets you copy your text as markdown, either a plain text editor or something in the middle like Ulysses that has an option to copy as Markdown. Notion instead copies as rich text by default, so if you write text in Notion then copy and paste it into Capiche, it will copy over only the plain text without any Markdown formatting.

Notion does let you export as Markdown, so here's what you'd do there:

  • Write in Notion, and select "Export" in the menu and choose Markdown.
  • Open the .md file that Notion exports in a text editor (Notepad on Windows or TextEdit on macOS would work fine).
  • Copy the raw markdown text there, and paste it into Capiche.
2 points
Livenadav's avatar
@Livenadav (replying to @maguay )
a year ago


Will try doing it TODAY.

2 points
AndyDentPerth's avatar
a year ago

I keep getting my quotes wrong because other platforms don't require a space after the greater-than.

Quote: Add the quoted text on its own line, then put a greater than symbol before the text like > this.

1 point
How do you manage your chat inbox?

Hey guys, first post here. As part of my work, I have to deal with and respond to a lot of incoming messages from different chats: Linkedin/WhatsApp/Signal/IG. I try to use Unreads/Archive features...

Which WordPress plugin do you recommend for Dynamic Content?

I'm working on a small side project and not concerned about SEO at all (which I realize can be an issue with dynamic content). I just want to display really targeted copy without coming off as cree...

The community for Capiche  power users.