Writing Your First Article

Articles are the core of your help center. This guide shows you how to create, edit, and publish your first one.

Creating a New Article

1. Navigate to Articles in the dashboard sidebar
2. Click the New Article button
3. Enter a title — this also generates the URL slug automatically

Using the Editor

HelpdeskHero gives you two ways to write:

• Markdown mode — write using standard Markdown syntax. Great if you are comfortable with Markdown and want full control.
• Visual mode — a rich text editor powered by Tiptap with a toolbar for formatting. Works just like a word processor.

You can switch between modes at any time. Your content is preserved when switching.

Adding Structure

Good help articles are well-organized. Use headings to break your content into sections:

## Main Section Heading
Content goes here...

### Subsection
More details...

Setting a Category

Choose a category from the dropdown in the article sidebar. This determines where the article appears in your help center navigation. If you have not created categories yet, visit the Categories section first.

Adding an Excerpt

The excerpt is a short summary shown in article listings and search results. Keep it concise — one or two sentences that describe what the article covers.

Publishing

When you are ready for customers to see your article:

1. Toggle the Published switch in the article sidebar
2. Click Save

Your article is now live on your public help center.

Editing the Slug

The URL slug is auto-generated from your title, but you can customize it. Click the slug field in the sidebar to edit it. If you change a slug after publishing, HelpdeskHero automatically creates a 301 redirect from the old URL so existing links keep working.