Skip to content

Hiding Markdown#

Hide or show Markdown: it's now your choice. FoldNotes hides Markdown's marks while you write, so a note reads like the finished page. The marks come back right where you're editing, and go again when you move on. Your file doesn't change: it's still plain Markdown, and opens the same in any other app.

It works the same on the Mac, iPad and iPhone. If you'd rather see every mark all the time, turn on Show Markdown.

What hides#

You type You see
## Chapter One Chapter One, as a heading
**bold**, *italic*, ~~struck~~, ==highlighted== the words, styled
`code` the code, on its grey background
[[Another note]] Another note, as a link
[the words](https://example.com) the words, as a link
> A quote the quote, with its stripe
- [ ] A task a square, then the task
![Caption](picture.png) the picture, with its caption above it
--- a faint line across the page
a table a neat grid: see Neat tables

Links stay links: click one to follow it, as before. A deeper quote keeps its depth as an indent.

Where the marks come back#

Only the part the cursor touches shows its marks. Put the cursor in or beside **bold** and its asterisks show; move away and they hide again. So your text only moves right at the cursor, never somewhere else on the line, and the arrow keys never stop beside a hidden mark.

  • A heading's # marks come back when the cursor is at the start of its words.
  • A link shows all of itself, address and all, while the cursor touches it.
  • A picture's whole reference comes back while the cursor touches it.
  • A table stays a neat grid and acts as one piece: you change it in the table editor (see Working with a neat table). Its Markdown shows only while you type its dashes row by hand.

Tasks as squares#

A task's - [ ] draws as a square, the same square as the Preview, and it stays a square even on the line you're typing on, so a task always looks like a task.

In the file The square
- [ ] open: an empty square
- [/] in progress: half filled
- [x] done: a tick, and the words dim
- [-] cancelled: a dash, and the words are struck through
  • Click the square to move the task to its next state. A click beside it only places the cursor, so a task is never marked done by accident.
  • The square acts as one character. The cursor stops before it or after it, never inside.
  • Backspace at the start of the words removes the square and leaves a plain line. Undo brings it back.
  • Return at the end of a task starts the next task, as before.

In Zen Mode the squares take one quiet colour.

What always shows#

  • Code blocks keep their fences, so their fold arrows and backgrounds have somewhere to sit, and the code inside is never touched. Code blocks have their own syntax colours.
  • Comments and list bullets and numbers show as you typed them.
  • External Files documents and Bike outlines always show their Markdown, because they belong to other apps.

Show Markdown#

Show Markdown turns Markdown mode back on: every mark shows all the time, as in FoldNotes before 1.2. It's a setting for each device.

  • Mac: Focus › Show Markdown (Control-Command-M), or Settings › Editor › Display › Show Markdown.
  • iPad and iPhone: Settings › Editor › Show Markdown, or in a note, the … menu › Focus & POS › Show Markdown. With a keyboard on iPad, View › Show Markdown (Control-Command-M).

Nothing in your file changes#

Hiding is only drawing. Every mark stays in the text and the file, so:

  • the note opens exactly the same in Obsidian, iA Writer or any other Markdown app;
  • Undo, folding, hoisting, search and Version History see the text as it is;
  • copying text copies its Markdown with it.