Skip to content

The editor

You edit a note on the note itself: there’s no separate editing area. Open one of your notes and select Edit. The page stays at the same address, with the body swapped for the editor.

Notes are stored as Markdown. The editor lets you write visually, and turns what you write back into tidy Markdown when you save, so you can switch between the two at any time.

  • Title: the note’s name, as shown in the tree and at the top of the page. Changing it doesn’t change the note’s address; see Renaming, moving and changing the address.
  • Note: the body, in the visual editor.

Above the body, the tag row shows the note’s tags, with a reminder: Type # in the note to add a tag, @ to link, / for a block.

  • Save saves the title and body and takes you back to the note, with Saved.
  • Cancel goes back without saving your last changes.

While you type, the body is also autosaved a couple of seconds after you stop, and whenever you switch away from the tab. The status beside Note says what’s happening: Unsaved changes, Saving…, then Saved and the time. If an autosave fails, it says Could not autosave. Your changes are still here; press Save.

Autosave only saves the body. A changed title is saved when you select Save. If you try to leave the page with unsaved changes, your browser asks you first.

Select M↓ Markdown to see and edit the raw Markdown instead. Select ¶ Rich text to go back. Both are the same note: whatever you change in one is there in the other.

In both views the body is a box of a fixed height that scrolls on its own, so however long the note is, Save stays just below it.

The Markdown view is a plain text box, which every keyboard handles well. If the visual editor ever misbehaves on a device, switch to Markdown and carry on.

Sometimes a note opens straight into Markdown with a message such as Editing as Markdown — this note contains <…>, which the rich editor cannot represent. That note has something in it the visual editor can’t show, and saving from the visual editor would lose it, so DragonNotes keeps you in Markdown.

The toolbar sits along the top of the body. On a tablet or wider it wraps onto a second row when it needs to. On a phone it stays just above the keyboard as one row that scrolls sideways, so it doesn’t cover what you’re typing. From left to right:

  • Bold, Italic, Strikethrough
  • Heading (H2) and Subheading (H3)
  • Bullet list, Numbered list, Checklist, Quote
  • Inline code, Code block, Table, Divider
  • Add a line below this block: adds an empty line under the block the cursor is in. From inside a table cell or a list in a quote, the line goes under the whole table or quote. See Getting out of a block.
  • Link: opens the Link box. Type or paste an Address and select Apply (or press Enter). With text selected, that text becomes the link; with nothing selected, the address itself goes in as a link. On an existing link, the box shows its address, and Remove link takes the link off. Cancel or Esc leaves things as they were. Web (http, https) and mailto addresses work. To link to another note, use @ instead; see Links.
  • Add an image and Attach a file
  • Undo and Redo

Buttons for formatting that’s already applied where the caret is are highlighted. For the keyboard shortcuts, see Writing a note.

With a keyboard, you leave a code block, quote or table by pressing ↓ past its end. On a phone there’s no down arrow, so there are two other ways:

  • Tap the empty space under the last block in the note, and a new line appears there, ready to type in.
  • Select Add a line below this block on the toolbar, wherever the block is in the note.

An empty line you add and never type in isn’t saved.

Type / at the start of a line and a menu opens. Keep typing to narrow it down, use ↑ and ↓ to choose, and press Enter to insert. Esc closes the menu.

Command What it inserts Also found by typing
Heading Section title h2, heading, title
Subheading Smaller title h3, subheading
Bullet list Unordered list, bullet, ul
Numbered list Ordered numbered, ordered, ol, 1
Checklist Tick-box list check, task, todo, tick, box
Quote Blockquote quote, blockquote
Code block Fenced code code, pre
Table 3 × 2 with a header row table, grid
Divider Horizontal rule divider, rule, hr, line
Callout — note, Callout — tip, Callout — warning A highlighted box with its kind as a label callout, aside, admonition, alert, or the kind itself

A / in the middle of a sentence (a date, say, or a path) doesn’t open the menu.

A callout is a quote with a label across the top, such as NOTE, for the thing a reader shouldn’t miss. Choose Callout — note, Callout — tip or Callout — warning from the / menu, then type inside it. A note or tip is drawn in your theme’s main colour, and a warning in its accent colour.

In Markdown, a callout is a quote whose first line names its kind:

> [!TIP]
> Water the seedlings before you transplant them.

NOTE, TIP, IMPORTANT, WARNING and CAUTION all work. Anywhere else that reads Markdown, such as an export, a callout is still an ordinary quote, so nothing is lost.

A checklist is a list of tick-boxes, saved as the usual Markdown - [ ] and - [x]. You can:

  • Choose Checklist from the toolbar or the / menu. On an existing list, it turns the items you’ve selected into tick-boxes, or back into plain bullets.
  • Type [ ] or [x] and a space at the start of a bullet.
  • Tick and untick boxes while editing. Pressing Enter at the end of an item starts a new, unticked one.

A list can mix tick-boxes and plain bullets. When you’re reading a note, its boxes show whether they’re ticked but can’t be changed; open the editor to tick them.

Choose Table from the toolbar or the / menu for a table of three rows and two columns with a header row. Press Tab to move between cells; pressing it in the last cell adds a row.

While the caret is in a table, a second bar appears with + Column, − Column, + Row, − Row, Header row (turns the first row into headings, or back) and Delete table.

To add an image, select Add an image, paste one, or drag one into the note.

Add an image opens Add a picture, which shows the pictures you’ve already added. Search them with Search by name…, and choose one to put it in this note. It’s the same file, not a second copy, so a picture you use on many notes is only stored once. To add a new one, select Upload a picture… (on a phone this offers the camera and your photos). You can upload several at once.

Pasting or dropping a picture always uploads it.

  • Before it’s uploaded, your browser shrinks any image larger than 2000 pixels on its longest edge. A smaller image is sent as it is. The status shows Preparing image…, then Uploading (resized)… or Uploading….
  • JPEG, PNG, GIF, WebP and AVIF pictures are shown in the note. Each has to be under 8 MB after shrinking, or you’ll see That image is still over 8MB after resizing. Try a smaller one.
  • HEIC photos (the iPhone’s usual format) are refused, because most browsers can’t show them. Export the photo as a JPEG first; on an iPhone, Settings › Camera › Formats › Most Compatible makes the camera save JPEGs.
  • The camera details and location stored in a photo are taken off before it’s kept.
  • When it’s done: Image added. It is only visible to whoever can see this note.

Every upload counts towards your storage. If the site has a storage limit and a file would take you past it, it’s refused with how much you’re using; delete files you no longer need, or ask an admin for more. You can upload up to 30 files an hour.

An image is visible to exactly the people who can see a note that shows it. Put it on a private note and only you can see it; use it on a public note and anyone who can read that note can see it too.

Images you take out of a note stay stored until you delete them. See Your files.

To attach any other file, such as a PDF, a spreadsheet or a zip, select Attach a file, or paste or drop it in. It appears in the note as a link with the file’s name. Files can be up to 25 MB.

A PDF opens in the browser when someone selects its link. Every other kind of file is downloaded rather than opened. As with images, an attachment can only be downloaded by people who can see a note it’s on: File attached. It is only downloadable by whoever can see this note.

Images and attachments need the visual editor. In the Markdown view the toolbar is hidden.

Files, at /your-name/-/media, lists everything you’ve uploaded, pasted or dropped, with each file’s size, when you added it, and what uses it: the notes that show it, an earlier version of a note, a site page, or your profile picture. The top of the page says how many files you have, how much space they take, and, if the site sets a limit, how much you can store. Reach it from Files on the Notes tab of Settings. When you have files nothing uses, the Unused line in Needs a tidy on your home base links there too.

A file can only be deleted once nothing uses it. A file that’s still in a note is marked in use; take it out of the note first. A picture that only an earlier version of a note shows counts as in use too, so restoring that version never brings back a broken picture.

For a file nothing uses, select Delete, then Delete it to confirm. When there are several, the notice at the top says how many and how much space they take, and Delete all … removes them together after you confirm with Delete them. If a file can’t be deleted just then, it stays listed and you can try again in a minute.

Everything the toolbar makes is ordinary Markdown, and you can type it directly: headings from # to ######, bold, italics, ~~strikethrough~~, lists, checklists, quotes, callouts, inline code and fenced code blocks, tables, horizontal rules, links and images. A web address on its own becomes a link. A single line break inside a paragraph is ignored; leave a blank line to start a new paragraph.

Only headings at levels 2 to 4 appear in a note’s On this page outline.