Markdown Support

Learn about the Markdown syntax supported by Moire

Apple Notes’ rich text format is complex. Moire supports converting it to a basic set of Markdown syntax. Here is the feature list.

note-example

Supported Features

Text Formatting

Syntax	Result
`Bold`	Bold
`Italic`	Italic
`~~Strikethrough~~`	~~Strikethrough~~

Headings

## Level 2 Heading
### Level 3 Heading

Only H2 and H3 are supported, corresponding to Notes’ Title and Subtitle. This is because Subheading in Notes is actually the same size as the body text and cannot be effectively distinguished.

Links

[Link Text](https://example.com)

Result: Link Text

Lists

Unordered List:

- Item 1
- Item 2
  - Sub-item 2.1

Ordered List:

1. Step One
2. Step Two
3. Step Three

Task List:

* [ ] TODO 1
  * [x] TODO 1.1
* [ ] TODO 2
  * [ ] TODO 2.1

Code Blocks

Monostyled text in Apple Notes will be converted to Markdown code blocks.

a = 5
b = 10
a, b = b, a
print(f"a is now {a}, b is now {b}")

Quotes

> This is a quote
> Used to emphasize important content

Result:

This is a quote Used to emphasize important content

Images

![Image Description](image-url.png)

Tables

Preview:

Header 1	Header 2
Content 1	Content 2

Known Issues

Style Loss

Bold, italic, and other styles may be lost if there are leading or trailing spaces in titles or body text.

Sync Inconsistencies

iOS and macOS export styles differently. iOS loses styles in titles and generates more empty line breaks (though usually not visible on the page).

macOS Title Behavior

On macOS, the first line of a note is always treated as a Bold Level 2 Heading by the Shortcuts API, regardless of its original formatting.

Best Practices

1. Keep It Simple

Use basic Markdown syntax and avoid relying on advanced features.

2. Use Lists Wisely

Lists are easier to read than large blocks of text. Benefits:

Concise and clear
Easy to scan

3. Use Images Appropriately

A picture is worth a thousand words, but don’t overdo it (limit 1).

Next Steps

Learn more about image upload mechanisms and limitations.

Image Upload Mechanism Learn how to use images in your notes