4 min read

Markdown and HTML: Tips to Leverage the Power of Custom Forms

February 20, 2020

DD Forms and Markdown

what is markdown

Markdown is a text-to-HTML conversion tool, free and open-source, designed to be lightweight and intuitive. It helps users to edit text in an easy and clean way - which is why we've decided it was the right tool for our DD Portal.

We highly recommend you save this Markdown Guide page and have it handy whenever you want to edit your Forms so they can be extra beautiful on top of being super smart.

when to use markdown

You know that DD Custom Forms already come with some integrated formatting on things such as the ticket title, the questions, the boxed statement question type, and other small things here and there.


If, however, you want to increase readability and potentially add bits in bolditalic, strikethrough, ordered and unordered lists, tables (!), links, images, linked images, and embed videos...

... well, you can!

PLEASE NOTE: you can use HTML and Markdown inside your question subtitles, but it won't work for question titles. We decided it was much tidier and resulted in better consistency if we kept the questions themselves with the same style.

As a general rule, use Markdown and HTML sparingly to avoid making your forms too busy to be used successfully.


check out some examples

Here's a couple of examples of things you can quickly achieve with just a few lines of Markdown:



Markdown can be really helpful in case you need to add a few lines of explanation in the Question Subtitle.

PLEASE NOTE: the example below shows the use of H2 and H3. While it's there to show what can be achieved, you shouldn't overuse heading styles when adding content in your question subtitles. And definitely do not use H1, ever. That's just really bad UX practice - trust us!


This is what you type when creating a Form in your Admin Console:


And this is what is rendered in the Client Portal:


Neat, huh?

DD Forms and HTML

If you happen to come across snippets of HTML code and don't want to spend time converting it to Markdown, feel free to just go with the HTML code. Don't cheat though, no scripts, no sneaky css. Just simple and clean HTML.

Embedding Videos

The most common example is a video embed, as the hosting space (YouTube, Wistia, Vimeo, etc) will typically give you a snippet ready to grab and use.

Pasting the embed code will make the video playable within the form, without getting redirected to a new page!

What you type in the Admin Console


What shows in the Client Portal:


Displaying Tables

Tables, the joy and bane of web development. You shouldn't use them, but they're oh so convenient and you can't really do without them. So, if you must, feel free to add HTML tables to your forms. They will render.

It's a bit of work, but if you can it pays off to transfer your precious table content inside Markdown syntax.

PLEASE NOTE: there's a 1k characters limit to the question subtitles so if you have a hefty amount of either HTML or Markdown, it might pay off to distribute it to multiple statement type questions.



That's it for now folks! Until next time.

DeskDirector Free Demo

Serena Cappellini

Written by Serena Cappellini

4 Challenges with an Automated Ticketing System – DeskDirector
Ticketing automation is “low hanging fruit” for most IT organizations: with the potential to ...
Read More
Microsoft Operations Framework: An In-Depth Overview – DeskDirector
IT service management (ITSM) can feel like solving a rubix cube: only the exact right combination ...
Read More
What Is Enterprise Service Management? All the Answers Inside – DeskDirector
Gartner expects business spending on IT to increase 6.8% in 2024, reaching $1.5 trillion by the end ...
Read More