Skip to main content

SmartDoc: Using Markdown

Markdown and keyboard shortcuts for SmartDoc: headings, lists, bold, code, mentions, record links and emoji.

Written by Peter Novosel

SmartDoc reads Markdown as you type: a hash and a space starts a heading, a dash and a space starts a list, and text wrapped in two asterisks is bold. The same shortcuts, plus @ for members and # for records, work anywhere in a SmartDoc.

Plan Availability

All plan types.

Permissions

Any member who can edit the record can use the shortcuts in its SmartDoc.

Platform

Web

Related Reading


Why use shortcuts?

Shortcuts keep your hands on the keyboard. Ctrl+B makes text bold, and # opens a picker to link a record in the current table.


Which Markdown starts a block?

Type at the start of a line

Result

> and a space.

A block quote.

Three backticks.

A code block.

- or * and a space.

A bulleted list.

1. and a space.

A numbered list; any number starts the count.

# to ###### and a space.

A heading, H1 to H6 by the number of hashes.


Which Markdown formats text inline?

Wrap the text in

Result

One backtick on each side.

Inline code.

Two asterisks on each side.

Bold.

One asterisk on each side.

Italic.

Two tildes on each side.

Strikethrough.


How do I mention a member or link a record?

  • Mention: type @ and the member's name, then pick from the list. The member is notified.

  • Record link: type # and the record's primary field value, then pick the record from the list.


Which keyboard shortcuts work?

Action

Shortcut

Bold.

Ctrl + B.

Italic.

Ctrl + I.

Strikethrough.

Ctrl + S.

Heading levels.

Shift + Ctrl + 1 to 5.

Paragraph formatting.

Shift + Ctrl + 0.

Select all.

Ctrl + A.

Line break.

Shift + Enter.

Horizontal line.

Ctrl + _.

Undo.

Ctrl + Z.

Redo.

Shift + Ctrl + Z.

On a Mac, use Cmd in place of Ctrl.


How do emoji and links work?

  • Type : and a keyword, such as :heart or :party, to search for an emoji. The text shortcuts :-) and ;-) convert to emoji as you type.

  • A web address typed into the document becomes a clickable link.

Last verified 22 Oct 2026.

Did this answer your question?