Overview
You can format task descriptions and comments in BugHerd. Instead of plain text, you can add headings, lists, links, code, and more.
This is useful when feedback needs structure: steps to reproduce, a checklist, or a link back to a design.
Placeholder for screen recording
(create or edit a task, apply a heading and a bullet list, add a link, @ mention a teammate, save. Hold 2 seconds on the saved description so it reads clearly.)
What you can format
In a task description or comment, you can:
Make text bold, italic, underlined, struck through or highlighted
Add headings (four sizes)
Add bullet, numbered, and checklist items
Add links
Add inline
codeand code blocksAdd a quote
Switch to Markdown source to edit the underlying text
Use the toolbar on the field, or type / to open a menu of formatting and (where they apply) BugHerd shortcuts. Keep typing after / to filter the list, for example /assign, /tag, or /bold.
You can also paste Markdown and use the usual keyboard shortcuts shown in the toolbar tooltips.
Placeholder for screenshot
(description field with the toolbar visible, showing a short “Steps to reproduce” heading, a 3-item list, and one link.)
When you create a task
You can provide rich text formatting for task descriptions whenever you create a task, either from the BugHerd sidebar or on the task board for your project.
Click the BugHerd tab and then click to choose the type of task to create.
Once the Create task modal appears, you'll notice the toolbar above with all the formatting options available.
Add headings, lists, links, or code from the toolbar, or type
/to the full menu of features.Fill out the rest of the task and submit as usual.
The same formatting options are also available later if updates to the description are required.
Placeholder for screen recording
(create-task description — toolbar, a short list, then / to assign.)
The / Menu (Replaces the old shortcuts)
On create task, the description would open a menu when one of the shortcuts for setting the severity ! , status $ , tags # , assigning @ , or linking a task ## .
Those actions are now in the / command menu, so they do not clash with markdown notation for the rich text formatting.
The / command menu will open up a menu with all the formatting features and any shortcuts available in whichever field it is triggered from.
The field in the Create task modal will have shortcuts to set severity, set status, assign users, link tasks and add tags
The comment field on a task will allow for users to be mentioned and tasks to be referenced.
When editing the description on an existing task, this menu will only feature the formatting options as is seen in the attached toolbar.
To filter the options in the menu, simply keep typing after the / and the list will show you the available options for the search term you've input. For example, /assign, /tag, /severity, plus a whole host of other ways you can focus this list to the specific function you wish to use.
Placeholder for screenshot
(/ menu on create task, showing Assign, Tag, Severity, Status, and Link task.)
Connected tools (Integrations)
If your project sends tasks or comments to another tool (GitHub, Linear, Jira, Asana, and others), BugHerd sends the written text, then converts it to what that tool supports.
What to expect:
Tools that speak markdown (for example GitHub or Linear) will usually show the same headings, lists and links.
Tools that use their own format (for example Jira or Asana) will get a close match, bold and lists typically come through; some extra styling may be simplified.
Comments that come back from those tools into BugHerd will keep basic formatting when this BETA is on for your workspace.
Titles in other tools still use plain text, so
**bold**will not appear in a GitHub issue title.
Your reporter, screenshot, browser details, and BugHerd links on the remote task stay as they are.
Placeholder for screenshot
(BugHerd description on the left, the tasme task in GitHub or Linear on the right)
Related Articles
Comments on Tasks