Back to Help Center

Markdown and Visual Editor Guide

HelpdeskHero offers two powerful editing modes for writing articles. You can switch between them at any time without losing your work.

Markdown Mode

Markdown mode gives you a plain text editor where you write using standard Markdown syntax. This is ideal if you prefer full control over formatting.

Supported Syntax

Element Syntax
Bold **bold text**
Italic *italic text*
Heading 2 ## Heading
Heading 3 ### Heading
Link [text](url)
Image ![alt](url)
Ordered list 1. Item
Unordered list - Item
Code block Triple backticks
Blockquote > Quote

YouTube Embeds

You can embed YouTube videos by simply pasting the URL on its own line:

https://www.youtube.com/watch?v=VIDEO_ID

HelpdeskHero automatically converts this into an embedded player on the public page.

Visual Mode

Visual mode provides a rich text editor with a familiar toolbar. You can:

  • Format text with bold, italic, and strikethrough buttons
  • Add headings, lists, and blockquotes from the toolbar
  • Insert links and images
  • Create callout blocks

Bubble Menu

When you select text in visual mode, a floating toolbar appears. This Bubble Menu lets you quickly apply formatting or use AI to rewrite the selected text.

The AI rewrite feature in the Bubble Menu requires an AI provider to be configured in your helpdesk settings.

Switching Between Modes

Click the toggle at the top of the editor to switch between Markdown and Visual modes. Your content is automatically converted when switching, so you never lose work.

Complex HTML or unusual formatting may be simplified when converting between modes. For best results, stick to standard Markdown elements.

Last updated on March 1, 2026