Formatting text

Where you can format text

The larger freeform fields in mizuiro - meeting minutes, task detail and check-ins, touchpoint notes, incident and performance write-ups, contact notes, kudos, and the rest - accept a small amount of markdown. Markdown is a plain, type-it-yourself way to add formatting: you write a couple of symbols around your text and mizuiro turns them into bold, a list, a link, and so on when the record is saved.

There’s no toolbar and no rich-text editor. You type the markers, and a formatting hint sits just below the field so you never have to remember them. The hint only shows the options that field actually supports, so it’s also how you tell, at a glance, whether a given field turns @names and #topics into links.

Note

Short single-line fields - a title, a name, a date - don’t format. Formatting is for the roomy “write as much as you like” boxes, which are exactly the ones that show the hint.

The markers

Emphasis

Wrap a word or phrase in a marker on each side.

You type	You get
`important`	important
`a little emphasis`	a little emphasis
`__underlined__`	underlined

You can combine them - **bold with *italic* inside** renders as bold with italic inside.

Lists

Start each line with - for a bulleted list, or 1. for a numbered one.

Type this:

Follow-ups from the call:
- send the revised quote
- book the site visit
- loop in the vendor

…and it renders as:

Follow-ups from the call:

send the revised quote
book the site visit
loop in the vendor

Numbered lists work the same way with 1., 2., 3. at the start of each line.

Line breaks

Just press Enter. A single new line stays a new line; a blank line starts a new paragraph. You don’t need any special marker for this.

Links that happen automatically

Some things become links without any markdown at all - you just type them normally:

@name links to a person in your directory. See @mentions.
#topic links to a subject page. See #topics.
An email address like [email protected] becomes a tap-to-email link. (Because of this, an email is always treated as an address, never as an @mention of its domain.)

Note

Every field that shows the hint links @names, but only a few fields (tasks and meeting minutes) actually record a #topic on the Topics page. On the fields that do, the hint shows a #topic chip; where it doesn’t, a #tag you type still reads as one but won’t feed the Topics trends. When in doubt, the hint below the field is the source of truth.

The hint below the field

The hint is a row of small chips, each previewing its own effect - the bold chip is bold, the italic chip is italic, and so on - so it doubles as a live legend. @name and #topic chips appear only on the fields where they apply.

Screenshot pending

A freeform notes field with a row of formatting chips beneath it: bold, italic, underline, list, numbered, and an @name chip, each chip previewing its own style

The formatting hint. Each chip shows both the marker you type and what it turns into.

What doesn’t work (and why)

The formatting is deliberately small and safe:

No raw HTML. If you paste <b> tags or a <script>, they show up as the literal text you pasted, not as formatting. This keeps notes safe no matter what gets pasted in.
No images or arbitrary links. The only things that become links are @mentions, #topics, and email addresses. A pasted web address stays plain text.

That’s the whole point: enough formatting to make a long note readable, nothing that could turn someone else’s notes into a surprise.