Post

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](https://capiche.com/).
  • 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](https://d.pr/tkjuTG+)
  • 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.

Mentioned
#Capiche
Share
NBNite's avatar
5 months ago

Super helpful guide.. thanks for sharing!

2 points
emre's avatar
5 months ago

I learned one more thing, thanks.

2 points
Livenadav's avatar
5 months 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 )
5 months 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 )
5 months ago

Superb!

Will try doing it TODAY.

2 points
AndyDentPerth's avatar
4 months 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 are your video call defaults?

Whether you've worked remotely for years, or moved your meetings to Zoom this year, there are certain things everyone does by default. Some leave their camera on or off. Some record calls for later...

The community for Capiche  power users.