{"id":22661,"date":"2022-04-04T12:50:45","date_gmt":"2022-04-04T12:50:45","guid":{"rendered":"https:\/\/refiner.io\/docs\/?post_type=knowledgebase&#038;p=22661"},"modified":"2026-02-23T13:59:33","modified_gmt":"2026-02-23T13:59:33","slug":"markdown","status":"publish","type":"knowledgebase","link":"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/","title":{"rendered":"Format Text with Markdown"},"content":{"rendered":"\n\n\n<h2 class=\"wp-block-heading\">Introduction<\/h2>\n\n\n\n<p>Markdown is a lightweight markup language for creating formatted text using a plain-text editor. Using Markdown syntax, you can include a link to a website, highlight a certain phrase, or embed an image to the description text.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"366\" src=\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44-1024x366.png\" alt=\"\" class=\"wp-image-22665\" srcset=\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44-1024x366.png 1024w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44-600x214.png 600w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44-768x274.png 768w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44.png 1212w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Example of basic text formatting and an external link using Markdown syntax<\/figcaption><\/figure><\/div>\n\n\n<p>Markdown can be added to the description text of a question and <a href=\"https:\/\/refiner.io\/docs\/kb\/question-types\/contact-information\/\">checkbox labels<\/a>. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"highlight\">Highlight text<\/h2>\n\n\n\n<p>You can use Markdown to highlight certain words in <strong>BOLD<\/strong> or <em>ITALIC<\/em>. <\/p>\n\n\n\n<p>The syntax for BOLD is adding two asterix before and after the phrase you want to highlight.<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"raw\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">The following words **are rendered in bold**. And the following words are *rendered in italic*.<\/pre>\n\n\n\n<p>The example above results in: <\/p>\n\n\n\n<p>&#8220;The following words <strong>are rendered in bold<\/strong>. And the following words are <em>rendered in italic<\/em>.&#8221;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"links\">Add web links<\/h2>\n\n\n\n<p>You can add links to other websites using Markdown. When a user clicks on the link, the target website will open in a new browser tab.<\/p>\n\n\n\n<p>The syntax of weblinks are square brackets containing the link text followed by round brackets containing the website URL.<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"raw\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">The following text [is a link](https:\/\/google.com) that leads to Google.<\/pre>\n\n\n\n<p>The example above will render as:<\/p>\n\n\n\n<p>&#8220;The following text <a href=\"https:\/\/google.com\" target=\"_blank\" rel=\"noreferrer noopener\">is a link<\/a> that leads to Google.&#8221;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"line-breaks\">Add line breaks<\/h2>\n\n\n\n<p>Line breaks are automatically detected whenever you have one blank line followed by additional text in the description text of a question.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"images\">Embed images<\/h2>\n\n\n\n<p>Markdown also allows you to add images that are hosted under a different domain (e.g. your website) to the description text of your question.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"722\" src=\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2024\/09\/Screenshot-2024-09-26-at-16.36.31-1024x722.png\" alt=\"\" class=\"wp-image-26325\" srcset=\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2024\/09\/Screenshot-2024-09-26-at-16.36.31-1024x722.png 1024w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2024\/09\/Screenshot-2024-09-26-at-16.36.31-800x564.png 800w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2024\/09\/Screenshot-2024-09-26-at-16.36.31-768x541.png 768w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2024\/09\/Screenshot-2024-09-26-at-16.36.31-1536x1083.png 1536w, https:\/\/refiner.io\/docs\/wp-content\/uploads\/2024\/09\/Screenshot-2024-09-26-at-16.36.31.png 1980w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Example of embedding an image to the question text using markdown<\/figcaption><\/figure><\/div>\n\n\n<p>The syntax for adding images is an exclamation mark, followed by square brackets, followed by round brackets containing the image URL and the desired size of the image.<\/p>\n\n\n\n<p>The following example will render an image from our website with 340&#215;200 pixels in size.<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"raw\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">![](https:\/\/refiner.io\/static\/images\/home\/hero.png=340x200)<\/pre>\n\n\n\n<p>If you don&#8217;t know the dimensions of your image, you can also just provide the desired height only as shown in the example below. In that case, the width of the image is automatically set.<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"raw\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">![](https:\/\/refiner.io\/static\/images\/home\/hero.png=200)<\/pre>\n\n\n\n<p>You can also provide an alternative text for your image to improve the accessibility of your survey.<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"raw\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">![An alternative text](https:\/\/refiner.io\/static\/images\/home\/hero.png=200)<\/pre>\n\n\n\n<p>The height of images is currently limited to 600px. The maximum width is set by the width of the <a href=\"https:\/\/refiner.io\/docs\/kb\/survey-editor\/styling\/#layout\">survey layout<\/a> (usually between 340px and 450px).<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Introduction Markdown is a lightweight markup language for creating formatted text using a plain-text editor. Using Markdown syntax, you can include a link to a website, highlight a certain phrase, or embed an image to the description text. Markdown can be added to the description text of a question and checkbox labels. Highlight text You [&#8230;]<\/p>\n<p><a class=\"btn btn-secondary understrap-read-more-link\" href=\"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/\">Read More&#8230;<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","template":"","knowledgebase_tag":[],"class_list":["post-22661","knowledgebase","type-knowledgebase","status-publish","hentry","knowledgebase_cat-customization"],"featured_image_urls_v2":{"full":"","thumbnail":"","medium":"","medium_large":"","large":"","1536x1536":"","2048x2048":"","ab-block-post-grid-landscape":"","ab-block-post-grid-square":"","gb-block-post-grid-landscape":"","gb-block-post-grid-square":""},"post_excerpt_stackable_v2":"<p>Introduction Markdown is a lightweight markup language for creating formatted text using a plain-text editor. Using Markdown syntax, you can include a link to a website, highlight a certain phrase, or embed an image to the description text. Example of basic text formatting and an external link using Markdown syntax Markdown can be added to the description text of a question and checkbox labels. Highlight text You can use Markdown to highlight certain words in BOLD or ITALIC. The syntax for BOLD is adding two asterix before and after the phrase you want to highlight. The following words **are rendered&hellip;<\/p>\n","category_list_v2":"","author_info_v2":{"name":"Moritz Dausinger","url":"https:\/\/refiner.io\/docs\/author\/user\/"},"comments_num_v2":"0 comments","acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v23.3 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Format Text with Markdown<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Format Text with Markdown\" \/>\n<meta property=\"og:description\" content=\"Introduction Markdown is a lightweight markup language for creating formatted text using a plain-text editor. Using Markdown syntax, you can include a link to a website, highlight a certain phrase, or embed an image to the description text. Markdown can be added to the description text of a question and checkbox labels. Highlight text You [...]Read More...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/\" \/>\n<meta property=\"og:site_name\" content=\"Refiner Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2026-02-23T13:59:33+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44-1024x366.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/\",\"url\":\"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/\",\"name\":\"Format Text with Markdown\",\"isPartOf\":{\"@id\":\"https:\/\/refiner.io\/docs\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44-1024x366.png\",\"datePublished\":\"2022-04-04T12:50:45+00:00\",\"dateModified\":\"2026-02-23T13:59:33+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/#primaryimage\",\"url\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44.png\",\"contentUrl\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44.png\",\"width\":1212,\"height\":433},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/refiner.io\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Format Text with Markdown\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/refiner.io\/docs\/#website\",\"url\":\"https:\/\/refiner.io\/docs\/\",\"name\":\"Refiner Documentation\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/refiner.io\/docs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/refiner.io\/docs\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/refiner.io\/docs\/#organization\",\"name\":\"Refiner Documentation\",\"url\":\"https:\/\/refiner.io\/docs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png\",\"contentUrl\":\"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png\",\"width\":400,\"height\":61,\"caption\":\"Refiner Documentation\"},\"image\":{\"@id\":\"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Format Text with Markdown","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/","og_locale":"en_US","og_type":"article","og_title":"Format Text with Markdown","og_description":"Introduction Markdown is a lightweight markup language for creating formatted text using a plain-text editor. Using Markdown syntax, you can include a link to a website, highlight a certain phrase, or embed an image to the description text. Markdown can be added to the description text of a question and checkbox labels. Highlight text You [...]Read More...","og_url":"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/","og_site_name":"Refiner Documentation","article_modified_time":"2026-02-23T13:59:33+00:00","og_image":[{"url":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44-1024x366.png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/","url":"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/","name":"Format Text with Markdown","isPartOf":{"@id":"https:\/\/refiner.io\/docs\/#website"},"primaryImageOfPage":{"@id":"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/#primaryimage"},"image":{"@id":"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/#primaryimage"},"thumbnailUrl":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44-1024x366.png","datePublished":"2022-04-04T12:50:45+00:00","dateModified":"2026-02-23T13:59:33+00:00","breadcrumb":{"@id":"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/#primaryimage","url":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44.png","contentUrl":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/04\/Screenshot-2022-04-04-at-14.48.44.png","width":1212,"height":433},{"@type":"BreadcrumbList","@id":"https:\/\/refiner.io\/docs\/kb\/customization\/markdown\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/refiner.io\/docs\/"},{"@type":"ListItem","position":2,"name":"Format Text with Markdown"}]},{"@type":"WebSite","@id":"https:\/\/refiner.io\/docs\/#website","url":"https:\/\/refiner.io\/docs\/","name":"Refiner Documentation","description":"","publisher":{"@id":"https:\/\/refiner.io\/docs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/refiner.io\/docs\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/refiner.io\/docs\/#organization","name":"Refiner Documentation","url":"https:\/\/refiner.io\/docs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/","url":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png","contentUrl":"https:\/\/refiner.io\/docs\/wp-content\/uploads\/2022\/11\/cropped-Group-8.png","width":400,"height":61,"caption":"Refiner Documentation"},"image":{"@id":"https:\/\/refiner.io\/docs\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase\/22661","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase"}],"about":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/types\/knowledgebase"}],"author":[{"embeddable":true,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/comments?post=22661"}],"version-history":[{"count":29,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase\/22661\/revisions"}],"predecessor-version":[{"id":26348,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase\/22661\/revisions\/26348"}],"wp:attachment":[{"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/media?parent=22661"}],"wp:term":[{"taxonomy":"knowledgebase_tag","embeddable":true,"href":"https:\/\/refiner.io\/docs\/wp-json\/wp\/v2\/knowledgebase_tag?post=22661"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}