Rich Text Content

Markdown elements display formatted text in your surveys. They are informational sections, not questions. Use them for instructions, context, disclaimers, or any other text content.

When to Use

Use markdown elements to display:

  • Survey introductions - Welcome message and survey purpose
  • Instructions - How to complete the survey or specific questions
  • Section headers - Organize your survey into distinct parts
  • Disclaimers and legal text - Privacy notices, terms, consent information
  • Explanatory content - Background information or definitions
  • Thank you messages - Closing text at the end of surveys
  • Contextual information - Help respondents understand what you’re asking

Formatting Options

Markdown supports rich text formatting:

Headings

# Main Heading

## Section Heading

### Subsection Heading

Text Formatting

**Bold text**
_Italic text_
**_Bold and italic_**
`Code or technical terms`

Lists

Unordered list:

- First item
- Second item
- Third item

Ordered list:

1. First step
2. Second step
3. Third step
[Link text](https://example.com)
[Privacy Policy](/privacy)

Emphasis

> Important note or callout

Best Practices

Keep It Scannable

  • Use headings to break up long sections
  • Keep paragraphs short (2-4 sentences)
  • Use bullet points for lists
  • Bold important keywords

Place Strategically

  • Beginning of survey: Welcome message and instructions
  • Section headers: Exaplain and group questions
  • Before complex questions: Additional instructions
  • End of survey: Thank you message

What Markdown Cannot Do

Markdown elements are display-only. They cannot:

  • Collect responses (use question elements instead)
  • Contain form inputs
  • Execute logic or calculations

Tips for Better Surveys

  • Mobile-first: Keep text short - it’s harder to read on small screens
  • Front-load information: Put most important text at the beginning
  • Break up long surveys: Use section headers to create mental checkpoints
  • Test readability: Have someone unfamiliar read your text
  • Use formatting sparingly: Too much bold/italic loses impact
  • Link to external sites: Use only when absollutely needed, they will break the flow for respondants

Accessibility Considerations

  • Use headings in order (don’t skip levels)
  • Write descriptive link text (“Read our privacy policy” not “Click here”)
  • Keep sentences clear and concise