Skip to main content

How to Use Markdown to Format Text in Outset

Omika Jikaria avatar
Written by Omika Jikaria
Updated over 2 weeks ago

You can use Markdown to format your screener and guide questions in Outset. This helps make your text clearer and easier to read, especially when you're writing longer prompts or want to emphasize key details.


1. Where Markdown Works in Outset

You can use Markdown in two places:

  • Screener questions: These have a built-in Markdown editor.

  • Guide questions: Markdown formatting must be added manually.

Formatting is visible to anyone who views the question—both researchers and participants.


2. Supported Markdown Elements

Outset supports GitHub-Flavored Markdown (GFM). Here are the elements you can use:

Text formatting

  • Italic: *italic* or _italic_

  • Bold: **bold** or __bold__

  • Strikethrough: ~~strikethrough~~

Lists

  • Bullet points: * Item or - Item

  • Numbered lists: 1. Item

  • Task lists:

    • [ ] Task not done

    • [x] Task done

Links and images

  • Links: [Link text](https://example.com)

  • Images: ![Alt text](https://url.com/image.png "Optional title")

Tables

| Column A | Column B | 
|----------|----------|
| Value 1 | Value 2 |

Footnotes

Here's a footnote.[^1] 
[^1]: This is the footnote content.

Autolinks

  • URLs and email addresses are automatically linked: www.example.com, https://example.com, [email protected]


3. Example Use Cases

Here are some ways researchers commonly use Markdown in Outset:

  • Clarifying long questions

    Please rate the following features: 
    * Ease of use
    * Design
    * Speed
  • Comparing items in a table

    | Option | Pros | Cons | 
    |--------|----------------|-----------------|
    | A | Fast, Cheap | Less flexible |
    | B | Highly Custom | Slower to setup |
  • Adding helpful links

    [View product screenshots](https://example.com/screenshots)

4. Preview Your Markdown

Make sure to test your Markdown formatting:

  1. Go to your interview.

  2. Click Test Interview.

  3. Choose the question you want to start the test from.

  4. Confirm that your formatting appears as expected.

This is especially important for guide questions, where you have to write the Markdown manually.


Hope this helps! If you have any further questions, please reach out to our team at [email protected] or via chat.

Did this answer your question?