Markdown is a lightweight markup language that lets you format text using plain text symbols. As of version 2.45, Hudu's block editor supports markdown in every rich text field, including KB articles and asset rich text fields. You can type markdown as you write, paste pre-formatted markdown, or import and export full documents. This article is a quick reference for markdown syntax and editor shortcuts in Hudu.
Visit Notion-Style Editor for additional information on the block editor, slash commands, and tables.
Guides
Importing and exporting markdown
Paste markdown directly into any rich text field and it converts to formatted content automatically. To import or export a file, use the markdown icons in the top right of the text menu. Imports and exports support CommonMark, GitHub Flavored Markdown (GFM), and HTML.
Editor shortcuts
Use these keyboard combinations to format text and manage your content quickly:
| Action | Windows | Mac |
|---|---|---|
| Bold | CTRL + B | CMD + B |
| Italic | CTRL + I | CMD + I |
| Underline | CTRL + U | CMD + U |
| Inline code | CTRL + E | CMD + E |
| Insert link | CTRL + K | CMD + K |
| Find and replace | CTRL + F | CMD + F |
| Undo | CTRL + Z | CMD + Z |
| Redo | CTRL + Y | CMD + SHIFT + Z |
Markdown formatting
Markdown lets you use simple symbols to apply formatting directly in the text. Below are commonly used elements:
Headers
| Syntax | Result |
|---|---|
| # + SPACE | Header 1 |
| ## + SPACE | Header 2 |
| ### + SPACE | Header 3 |
| #### + SPACE | Header 4 |
Other formatting
| Format | Syntax |
|---|---|
| Bulleted list | - or * then SPACE |
| Numbered list | 1. then SPACE |
| Task list | [ ] or [x] then SPACE |
| Italic | *TEXT* |
| Bold | **TEXT** |
| Bold and italic | ***TEXT*** |
| Strikethrough | ~~TEXT~~ |
| Inline code | `TEXT` |
| Code block | ``` or ~~~ then SPACE |
| Blockquote | > then SPACE |
| Horizontal divider | --- or ___ then SPACE |
To apply syntax highlighting to a code block, type the language name right after the backticks or tildes, before the space (for example, ```powershell).
For elements without a markdown shortcut, like tables, callouts, and images, type / at the start of a line to open the slash command menu.
FAQ
Yes. As of version 2.45, markdown shortcuts, paste, and import/export work in every rich text field across Hudu, including rich text fields on assets.
Task list items can only be checked or unchecked while editing. They display as read-only in view mode.
Troubleshooting
Content pasted from other sources may need minor formatting cleanup after pasting. For longer documents, try importing the markdown file with the import icon in the top right of the text menu instead of pasting.