{"id":694,"date":"2022-01-14T12:00:27","date_gmt":"2022-01-14T12:00:27","guid":{"rendered":"https:\/\/mailinvest.blog\/index.php\/2022\/01\/14\/what-is-markdown-and-how-do-you-use-it\/"},"modified":"2022-01-14T12:00:27","modified_gmt":"2022-01-14T12:00:27","slug":"what-is-markdown-and-how-do-you-use-it","status":"publish","type":"post","link":"https:\/\/mailinvest.blog\/index.php\/2022\/01\/14\/what-is-markdown-and-how-do-you-use-it\/","title":{"rendered":"What Is Markdown, and How Do You Use It?"},"content":{"rendered":"

<\/a>\n<\/p>\n

\n

\"Markdown<\/p>\n

Markdown is a simple syntax that formats text as headers, lists, boldface, and so on. This markup language is popular, and you definitely have apps that support it. Here\u2019s a quick primer on what Markdown is, and how and where you can use it.<\/p>\n

What Is Markdown?<\/h2>\n

When you add bold, italics, numbered lists, bullet points, headings, and so on to text, you\u2019re \u201cformatting\u201d it. Markdown is a syntax\u2014or, set of rules\u2014that formats text on web pages.<\/p>\n

Traditionally, to format text on web pages, people used Hypertext Markup Language, better known as HTML. HTML is one member of the family of markup languages, along with eXtensible Markup Language (XML) and Standard Generalized Markup Language (SGML).<\/p>\n

To format text with HTML, you put tags around the text. For example, if you want to bold text, you type \u201c<b> this is some bold text <\/b>\u201d.<\/p>\n

When your web browser \u201creads\u201d a web page, it interprets the HTML tags and applies the relevant formatting. When it sees \u201c<b> this is some bold text <\/b>\u201d, it understands that anything between the <b> and <\/b> tags should appear in bold<\/strong>. The browser also hides the tags (<b> and <\/b>).<\/p>\n

HTML can be quite complex, with dozens and dozens of tags,<\/a> such as <span>, <div>, <kbd>, <ol>, and lots of others. Computers have no trouble reading these because they just follow the syntax (the rules of HTML) and apply the formatting that matches the tags.<\/p>\n

The tags, however, make it quite difficult for humans to read HTML and understand how the text will look after the computer renders it. It\u2019s not very \u201cuser-friendly\u201d for people who don\u2019t have a lot of experience reading it.<\/p>\n

RELATED:<\/strong> How to View the HTML Source in Google Chrome<\/em><\/strong><\/a><\/p>\n

Markdown, on the other hand, is meant \u201cto be as easy-to-read and easy-to-write as is feasible<\/a>.\u201d John Gruber and Aaron Schwartz explain why they created Markdown in 2004 and provide a guide to the syntax on Gruber\u2019s website<\/a>.<\/p>\n

In short, Markdown makes it easier to format text for web pages because its tags are simpler than HTML, and they convert to HTML automatically. This means you don\u2019t have to know HTML to write something for a web page because Markdown translates your tags into HTML for you.<\/p>\n

It doesn\u2019t cover all possible HTML tags, but, rather, the most common formatting options.<\/p>\n

How Do You Use Markdown?<\/h2>\n

To use Markdown, you just apply simple tags to your text. For example, to format text in italics, you put underscores around it like so: _this is some text in italics_.<\/p>\n

Here are some other examples of Markdown formatting from the\u00a0syntax guide<\/a>:<\/p>\n

Headers<\/h3>\n

# This is an H1<\/p>\n

## This is an H2<\/p>\n

###### This is an H6<\/p>\n

Bullet Points<\/h3>\n

* Red
* Green
* Blue<\/p>\n

Numbered Lists<\/h3>\n

1. Bird
2. McHale
3. Parish<\/p>\n

Emphasis (Italics)<\/h3>\n

*text*
_text_<\/p>\n

Markdown converts both *text* and _text_ to the HTML <emphasis> or <em> tag, which, in theory, can be interpreted in many ways. For example, you could build an app that interprets the <emphasis> tag as flashing red text. In practice, however, almost every application (including every web browser) interprets it as italicized text.<\/p>\n

Strong (Bold)<\/strong><\/p>\n

**text**
__text__<\/p>\n

Markdown converts both **text** and __text__ to the HTML <strong> tag, which typically appears as bolded text. In other words, for additional emphasis, use double * or _ characters.<\/p>\n

There are also variants of Markdown\u2014such as CommonMark<\/a> and\u00a0GitHub Flavored Markdown<\/a> (GFM)\u2014but these are all based on the original Markdown specification. Variants usually just extend the standard by adding formatting tags the original Markdown doesn\u2019t cover.<\/p>\n

After you format your text, an application has to convert it to HTML, which is usually done automatically. For example, README files in GitHub<\/a> use Markdown, and as long as they have a .MD file extension, GitHub automatically converts them to the correct HTML tags when they\u2019re published.<\/p>\n

So, in most cases, you won\u2019t have to do this yourself, but if you do, there\u2019s a Markdown tool<\/a>\u00a0available.<\/p>\n

RELATED:<\/strong> What Is GitHub, and What Is It Used For?<\/em><\/strong><\/a><\/p>\n

Where Can You Use Markdown?<\/h2>\n

As we mentioned above, you can use Markdown on GitHub, but also on Reddit, StackOverflow, and other websites. If you\u2019ve ever\u00a0formatted text in WhatsApp messages<\/a> or Slack conversations, you\u2019ve already used it because these applications use a (very small) subset of Markdown tags to format text.<\/p>\n

If you want to learn Markdown, check out the original Markdown syntax guide<\/a> or a third-party tutorial site<\/a>. It\u2019s easy to learn, and it\u2019ll make your README files, and Reddit or StackOverflow comments easier for others to read.<\/p>\n<\/div>\n