Basic formatting

Mochi uses Markdown to format text inside cards. Markdown is a lightweight syntax that lets you add structure—headings, emphasis, lists, images, links, references, and more—without leaving the keyboard. This guide covers the most common formatting options you’ll use when creating cards.

You can copy each example directly into a card to see how it renders.

Headings

Use # symbols to create headings. More # symbols make smaller headings.

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

Bold, italics, highlights

**bold text**
_italic text_
**_bold and italic_**
~~strikethrough~~
==highlighted text==

Use strikethrough for corrections, revisions, or marking outdated terms. Highlights are useful for drawing attention to key terms or definitions.

Lists

Unordered list

You can use - or * as bullets for unordered lists.

- Item one
- Item two
- Item three

Ordered list

1. First step
2. Second step
3. Third step

Nesting lists

You can indent lines in a list to created nested lists. Use TAB and SHIFT-TAB to indent and outdent a line, respectively.

- Some item
  - Nested item
- Another item
  1. First nested item
  2. Second nested item

Blockquotes

Add a > before text to make it a blockquote.

> I have never seen a thin person drinking Diet Coke.  

- Donald Trump, 2012

Code

Inline code

Use a single backtick ` on either side of the code snippet to create inline code blocks.

Use `inline code` for short snippets.

Code blocks

Use three backticks to create a code block or code fence.

 ```
 project
 ├── src
 │   ├── main.js
 │   └── utils.js
 ├── assets
 │   ├── logo.png
 │   └── styles.css
 └── README.md
 ```

Add syntax highlighting by postfixing the name of the language after the first three backticks.

 ```python
 print("Hello, World!")
 ```

Horizontal rule

Use four or more dashes to create a horizontal rule.
----

Links

External links

[Visit Mochi](https://mochi.cards)

Internal references (links to other cards)

You can link to another card using double brackets:

See also: [[Photosynthesis]].

Typing [[ opens a quick search box. Mochi automatically adds a backlink on the referenced card. See References for more details.

Images & media

Media can be attached by dragging and dropping a file onto the editing area, or pasting an image that's been copied to the clipboard. The media will be stored locally and displayed using standard markdown syntax.

Images can also be embedded via a URL, either hosted locally on your computer or on a server.

![A cat](image-name.jpg)

The above syntax will work for audio and video files as well. If the card is deleted, the associate media will be deleted as well.

For images, you can adjust the dimensions by adding |800x600 to the image title. The first number will be the width, and the second number the height. If you exclude the height, the image will resize proportionally.

![Some Image|800x600](image-name.jpg)
![Some Image|800](image-name.jpg)

Tags

Inline #tags written in the card’s Markdown automatically become card metadata.

#biology #chapter3

Hierarchical tags

You can create nested tags by adding forward slashes (/) in your tags. For example #sports/basketball/stats will create a #stats tag that is nested under the #basketball tag which is in turn nested under the #sports tag.

Footnotes

Mochi supports standard Markdown footnotes.

Water is essential for life.[^1]

[^1]: And for making tea.

Footnotes appear at the bottom of the card’s rendered output.