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
What self-hosted software do you use?

The CMS for your blog or website is likely self-hosted—unless you're using a service like Ghost's hosting or a website builder tool like Squarespace. That's often supplemented with hosted services...

Is Zoom still the best? What's your favorite video calls app?

After a year in which everything possible seemed to happen over Zoom, the video chat app's name is cemented in our lexicon—enough that "Zoom Fatigue" is the default name for feeling tired after one...

What software changed how you think and work?

Most new software adds a slight new twist to the way you already work—perhaps it helps you send email faster or add notes automatically, but generally works in the same way as other tools in the ca...

The community for Capiche  power users.