{"id":92323,"date":"2019-09-13T16:30:40","date_gmt":"2019-09-13T21:30:40","guid":{"rendered":"https:\/\/wpengine.com\/?post_type=resource&#038;p=92323"},"modified":"2024-10-02T14:44:14","modified_gmt":"2024-10-02T19:44:14","slug":"using-markdown-wordpress","status":"publish","type":"resource","link":"https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/","title":{"rendered":"How To Use Markdown in WordPress"},"content":{"rendered":"\n<p>Sometimes it\u2019s easier to create your website\u2019s content outside of the WordPress editor. If you prefer a word processor like Microsoft Word or Google Docs, however, you might have experienced the frustration of breaking your post or page when you paste in new text.<\/p>\n\n\n\n<p>Fortunately, <a href=\"https:\/\/daringfireball.net\/projects\/markdown\/\">you can use Markdown<\/a> to more easily create content within your site. This is especially helpful if you\u2019re working with multiple contributors who all like to write using different tools. You can simply style and format the page or post once the text is complete.&nbsp;<\/p>\n\n\n\n<p>In this article, we\u2019ll explore what markdown is and how you can use it in WordPress. Also, we\u2019ll take a look at how to use plugins to get the most use out of this option. Let\u2019s get started!&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What is Markdown?<\/h2>\n\n\n\n<p>Markdown is a plain-text form of syntax. This means it\u2019s free of styles and formatting that have unseen coding, which might not play well when pasted into a WordPress post or page.<\/p>\n\n\n\n<p>Additionally, Markdown is also <a href=\"https:\/\/daringfireball.net\/projects\/markdown\/\">the name of a software tool<\/a> that creates a text-to-HTML function for writers and editors.&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Benefits and Disadvantages of Markdown in WordPress<\/h2>\n\n\n\n<p>There are some significant advantages to <a href=\"https:\/\/www.elegantthemes.com\/blog\/tips-tricks\/using-markdown-in-wordpress\" target=\"_blank\" rel=\"noreferrer noopener\">using Markdown in WordPress<\/a>, especially if there are many individuals working on your site\u2019s content. Let\u2019s take a look at what Markdown has to offer:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>It can streamline the creation process. <\/strong>You can implement a standardized way of creating text and executing the editing process.&nbsp;&nbsp;&nbsp;<\/li>\n\n\n\n<li><strong>The learning curve is small.<\/strong> Markdown is not complicated, and it can be learned quickly.&nbsp;<\/li>\n\n\n\n<li><strong>You can focus on content.<\/strong> This approach can help to eliminate the distraction of fonts, styles, and structures used in other processors.&nbsp;<\/li>\n\n\n\n<li><strong>It is very flexible. <\/strong>Markdown eliminates problems with compatibility and portability, as it can be exported in many different formats.&nbsp;<\/li>\n<\/ul>\n\n\n\n<p>Markdown definitely has a lot going for it. To be fair, however, let\u2019s also take a look at some of the downsides to this option.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>There are too many &#8220;flavors.&#8221;<\/strong> Since Markdown lacked standardization from the very beginning, developers often <a href=\"https:\/\/github.com\/commonmark\/commonmark-spec\/wiki\/markdown-flavors\">created their own &#8220;flavor&#8221; of it<\/a>, which can sometimes cause issues.&nbsp;<\/li>\n\n\n\n<li><strong>It is difficult to extend the language.<\/strong> Markdown is essentially finite at this point, and extending the syntax means you\u2019ll be essentially creating a new language (although <a href=\"https:\/\/talk.commonmark.org\/t\/generic-directives-plugins-syntax\/444\">there <em>is<\/em> work<\/a> being done to solve this issue).&nbsp;<\/li>\n\n\n\n<li><strong>There is a lack of semantic meaning.<\/strong> Markdown is meant for writing text only, so there are some things you can\u2019t do, such as identify a class. Some people add in HTML to cope with this, but that means the result will no longer be transferable to other formats.<\/li>\n<\/ul>\n\n\n\n<p>Although there are a few disadvantages to Markdown, it is still a highly valuable tool. This is particularly true for content creation and agency work within WordPress. If you\u2019re creating large sets of documentation, however, you might want to review your other options as well.&nbsp;&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Enabling Markdown<\/h2>\n\n\n\n<p>At this point, you may be wondering how you can use Markdown in WordPress. When it comes to <a href=\"https:\/\/wpengine.com\/resources\/how-to-use-wordpress\/\">self-hosted WordPress.org<\/a> (which we highly recommend), there\u2019s no built-in support for Markdown or simple way to enable it by default. Don\u2019t worry though\u2014you can easily use Markdown with the help of a plugin.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Enabling Markdown Using Plugins (In 2 Steps)<\/h2>\n\n\n\n<p>As with many WordPress-related tasks, the best way to get started with Markdown is by <a href=\"https:\/\/wpengine.com\/blog\/popular-wordpress-plugins\/\" target=\"_blank\" rel=\"noreferrer noopener\">picking up the right plugin<\/a>. Let\u2019s walk through the process for enabling Markdown in self-hosted WordPress.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Step 1: Install the Jetpack Plugin<\/h3>\n\n\n\n<p>While there are multiple plugins available that can help you enable Markdown in WordPress, our favorite option is <a href=\"https:\/\/wordpress.org\/plugins\/jetpack\/\">Jetpack<\/a>.<\/p>\n\n\n\n<p>This is an all-in-one plugin that provides a multitude of features for enhancing your site\u2019s performance, Search Engine Optimization (SEO), security, <a href=\"https:\/\/wpengine.com\/resources\/wordpress-social-media\/\">social media integration<\/a>, and more. Many users will already have this plugin active on their sites, making it a simple solution.<\/p>\n\n\n\n<p>What\u2019s more, <a href=\"https:\/\/jetpack.com\/support\/markdown\/\">you can enable Markdown<\/a> in Jetpack\u2019s free version\u2014you won\u2019t need a premium plan. So your first step is to <a href=\"https:\/\/wordpress.org\/plugins\/jetpack\/#installation\">install and activate Jetpack<\/a> on your site if you don\u2019t already have it. Then, you\u2019re ready to move on to the next stage.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Step 2: Access Jetpack\u2019s Settings to Enable Markdown<\/h3>\n\n\n\n<p>Once Jetpack is set up on your site, locate the new <em>Jetpack<\/em> tab and navigate to the plugin\u2019s <em>Settings<\/em>.<\/p>\n\n\n\n<p>Switch over to the <em>Writing<\/em> tab, and look under the <em>Composing<\/em> section. Here, you\u2019ll see an option labeled <em>Write posts or pages in plain-text Markdown syntax<\/em>.<\/p>\n\n\n\n<p>Simply toggle this option on, and that\u2019s all you need to do! Now if you navigate to any post, page, or custom content type, you\u2019ll be able to add a <em>Markdown<\/em> block.<\/p>\n\n\n\n<p>Here, you can enter your Markdown text and preview what it will look like.<\/p>\n\n\n\n<p>It\u2019s also worth noting that if you like, you can also enable Markdown for comments. To do so, navigate to <em>Jetpack &gt; Settings &gt; Discussion<\/em>.<\/p>\n\n\n\n<p>Toggle the <em>Enable Markdown use for comments<\/em> option here. Then, visitors to your site will be able to <a href=\"https:\/\/wpengine.com\/resources\/stop-wordpress-comment-spam\/\">compose their comments<\/a> in Markdown if they like.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Writing With Markdown<\/h2>\n\n\n\n<p>Once you\u2019ve enabled Markdown on your WordPress site, you can start using it to create content. If you\u2019re new to using this particular tool, don\u2019t worry. Writing content with Markdown is actually quite simple.<\/p>\n\n\n\n<p>When using Markdown, you\u2019ll type in your text content and then format it by using special characters. These characters are meant to be simple and universal. When it comes to displaying your content, however, they\u2019ll be automatically converted into the formatting and styles you\u2019re used to.<\/p>\n\n\n\n<p>Here are a few examples of the styles you can use when writing with Markdown:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Asterisks to italicize text: *Title* becomes <em>Title<\/em>.<\/li>\n\n\n\n<li>Double asterisks to bold text: **Click Here** becomes <strong>Click Here<\/strong>.<\/li>\n\n\n\n<li>Brackets and parentheses to indicate links: [WordPress](https:\/\/wordpress.org) becomes <a href=\"https:\/\/wordpress.org\">WordPress<\/a>.<\/li>\n<\/ul>\n\n\n\n<p>There\u2019s a lot more you can do with Markdown, of course. We\u2019d suggest <a href=\"https:\/\/daringfireball.net\/projects\/markdown\/syntax\">checking out the official documentation<\/a> for a complete list of all the syntax options that are available. With a little practice, you should find yourself writing in Markdown like a pro in no time.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Do Things Your Way With WP Engine<\/h2>\n\n\n\n<p>WordPress is all about flexibility. The core platform is lean, so you can add on the features you need and create a workflow that makes sense for you. If that involves <a href=\"https:\/\/daringfireball.net\/projects\/markdown\/\">creating content in Markdown<\/a>, you\u2019ll be glad to know that <a href=\"https:\/\/wordpress.org\/plugins\/jetpack\/\">the Jetpack plugin<\/a> makes the process simple.<\/p>\n\n\n\n<p>Here at WP Engine, we want to support you in building and running a website that meets your needs. To do that, you\u2019ll need <a href=\"https:\/\/developer.wordpress.org\/\">expert resources<\/a>, along with a <a href=\"https:\/\/wpengine.com\/plans\/\">top-quality hosting plan to support your WordPress site<\/a>. Create a better digital experience for your site\u2019s visitors today with WP Engine&#8217;s <a href=\"https:\/\/wpengine.com\/wordpress-hosting\/\" target=\"_blank\" rel=\"noreferrer noopener\">premium hosting for WordPress<\/a>!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Sometimes it\u2019s easier to create your website\u2019s content outside of the WordPress editor. If you prefer a word processor like Microsoft Word or Google Docs, however, you might have experienced the frustration of breaking your post or page when you paste in new text. Fortunately, you can use Markdown to more easily create content within<span class=\"tile__ellipses\">&hellip;<\/span><span class=\"tile__ellipses--animated\"><\/span><\/p>\n","protected":false},"author":297,"featured_media":146009,"template":"","resource-topic":[904,901],"resource-role":[895,906,903,1296],"resource-type":[916],"class_list":["post-92323","resource","type-resource","status-publish","has-post-thumbnail","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v20.9 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Using Markdown in WordPress<\/title>\n<meta name=\"description\" content=\"Love using markdown and feeling constrained without it in WordPress? Fret no more! WP Engine is here to help you use markdown within WordPress.\" \/>\n<meta name=\"robots\" content=\"noindex, follow\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Using Markdown in WordPress\" \/>\n<meta property=\"og:description\" content=\"Love using markdown and feeling constrained without it in WordPress? Fret no more! WP Engine is here to help you use markdown within WordPress.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/\" \/>\n<meta property=\"og:site_name\" content=\"WP Engine\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/wpengine\" \/>\n<meta property=\"article:modified_time\" content=\"2024-10-02T19:44:14+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2019\/09\/markdown-header.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1100\" \/>\n\t<meta property=\"og:image:height\" content=\"500\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:title\" content=\"Using Markdown in WordPress\" \/>\n<meta name=\"twitter:description\" content=\"Love using markdown and feeling constrained without it in WordPress? Fret no more! WP Engine is here to help you use markdown within WordPress.\" \/>\n<meta name=\"twitter:image\" content=\"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2019\/09\/markdown-header.png\" \/>\n<meta name=\"twitter:site\" content=\"@wpengine\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/\",\"url\":\"https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/\",\"name\":\"Using Markdown in WordPress\",\"isPartOf\":{\"@id\":\"https:\/\/wpengine.com\/case-studies\/#website\"},\"datePublished\":\"2019-09-13T21:30:40+00:00\",\"dateModified\":\"2024-10-02T19:44:14+00:00\",\"description\":\"Love using markdown and feeling constrained without it in WordPress? Fret no more! WP Engine is here to help you use markdown within WordPress.\",\"breadcrumb\":{\"@id\":\"https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/wpengine.com\/case-studies\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Resources\",\"item\":\"https:\/\/wpengine.com\/case-studies\/resources\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"How To Use Markdown in WordPress\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/#website\",\"url\":\"https:\/\/wpengine.com\/case-studies\/\",\"name\":\"WP Engine\",\"description\":\"Managed Hosting for WordPress\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/wpengine.com\/case-studies\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/3a22232b01de39dcf588fb8e421c0521\",\"name\":\"Erin Myers\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/cd881e115bc28c81642ec61752db9981ece9ee8b4c81498a9b6276b9cdcaf5e6?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/cd881e115bc28c81642ec61752db9981ece9ee8b4c81498a9b6276b9cdcaf5e6?s=96&d=mm&r=g\",\"caption\":\"Erin Myers\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Using Markdown in WordPress","description":"Love using markdown and feeling constrained without it in WordPress? Fret no more! WP Engine is here to help you use markdown within WordPress.","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"Using Markdown in WordPress","og_description":"Love using markdown and feeling constrained without it in WordPress? Fret no more! WP Engine is here to help you use markdown within WordPress.","og_url":"https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/","og_site_name":"WP Engine","article_publisher":"https:\/\/www.facebook.com\/wpengine","article_modified_time":"2024-10-02T19:44:14+00:00","og_image":[{"width":1100,"height":500,"url":"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2019\/09\/markdown-header.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_title":"Using Markdown in WordPress","twitter_description":"Love using markdown and feeling constrained without it in WordPress? Fret no more! WP Engine is here to help you use markdown within WordPress.","twitter_image":"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2019\/09\/markdown-header.png","twitter_site":"@wpengine","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/","url":"https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/","name":"Using Markdown in WordPress","isPartOf":{"@id":"https:\/\/wpengine.com\/case-studies\/#website"},"datePublished":"2019-09-13T21:30:40+00:00","dateModified":"2024-10-02T19:44:14+00:00","description":"Love using markdown and feeling constrained without it in WordPress? Fret no more! WP Engine is here to help you use markdown within WordPress.","breadcrumb":{"@id":"https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/wpengine.com\/case-studies\/resources\/using-markdown-wordpress\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/wpengine.com\/case-studies\/"},{"@type":"ListItem","position":2,"name":"Resources","item":"https:\/\/wpengine.com\/case-studies\/resources\/"},{"@type":"ListItem","position":3,"name":"How To Use Markdown in WordPress"}]},{"@type":"WebSite","@id":"https:\/\/wpengine.com\/case-studies\/#website","url":"https:\/\/wpengine.com\/case-studies\/","name":"WP Engine","description":"Managed Hosting for WordPress","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/wpengine.com\/case-studies\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/3a22232b01de39dcf588fb8e421c0521","name":"Erin Myers","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/wpengine.com\/case-studies\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/cd881e115bc28c81642ec61752db9981ece9ee8b4c81498a9b6276b9cdcaf5e6?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/cd881e115bc28c81642ec61752db9981ece9ee8b4c81498a9b6276b9cdcaf5e6?s=96&d=mm&r=g","caption":"Erin Myers"}}]}},"acf":[],"grid_image_url":"https:\/\/wpengine.com\/case-studies\/wp-content\/uploads\/2019\/09\/markdown-grid.png","media-type":{"term_id":916,"name":"Article","slug":"article"},"role":"<strong>Roles:<\/strong> Agency, Entrepreneur, Marketer, Publisher","topic":"<strong>Topics:<\/strong> Marketing, WordPress","_links":{"self":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource\/92323","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource"}],"about":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/types\/resource"}],"author":[{"embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/users\/297"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/media\/146009"}],"wp:attachment":[{"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/media?parent=92323"}],"wp:term":[{"taxonomy":"resource-topic","embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource-topic?post=92323"},{"taxonomy":"resource-role","embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource-role?post=92323"},{"taxonomy":"resource-type","embeddable":true,"href":"https:\/\/wpengine.com\/case-studies\/wp-json\/wp\/v2\/resource-type?post=92323"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}