Go back

How To Write In Markdown

by Alex Melia

Cover image

Markdown is a lightweight markup language that makes it easy to format plain text. Whether you're writing documentation, a blog post, or notes, Markdown provides a simple way to add formatting without the complexity of HTML. This guide will introduce you to the basics of Markdown and how you can use it to create well-formatted text.

This blog post was generated using ChatGPT

Headings

Headings are created using the # symbol. The number of # symbols at the beginning of the line indicates the heading level. For example:

    # Heading 1
    ## Heading 2
    ### Heading 3
    #### Heading 4
    ##### Heading 5
    ###### Heading 6

Emphasis

You can add emphasis to text using asterisks * or underscores _.

  • Bold: Use ** or __ to make text bold.

This is bold text This is also bold text

  • Italic: Use * or _ to italicize text.

This is italic text This is also italic text

  • Bold and Italic: Use *** or ___ for bold and italic text.

This is bold and italic text This is also bold and italic text

Lists

Markdown supports both ordered and unordered lists.

  • Unordered List: Use -, *, or + followed by a space.

  • Item 1

  • Item 2

    • Subitem 1
    • Subitem 2
  • Ordered List: Use numbers followed by a period.

  1. First item
  2. Second item
    1. Subitem 1
    2. Subitem 2

Links

To create a hyperlink, use the following syntax:

Link text

Example: Visit GitHub

Images

Embedding images in Markdown is similar to creating links but with an exclamation mark ! at the beginning.

Alt text

Example: Markdown Logo

Blockquotes

Blockquotes are used to highlight a quote or a block of text. Use the > symbol at the beginning of the line.

This is a blockquote.

It can span multiple lines.

Code

For inline code, use backticks `.

This is inline code.

For code blocks, use triple backticks.

    function helloWorld() {
        console.log("Hello, world!");
    }

Horizontal Rules

To create a horizontal rule, use three or more asterisks ***, dashes ---, or underscores ___ on a line by themselves.


Tables

Tables can be created using pipes | and dashes -.

| Header 1 | Header 2 | | -------- | -------- | | Row 1 | Data 1 | | Row 2 | Data 2 |

Task Lists

Task lists are useful for creating checklists.

  • [x] Completed task
  • [ ] Incomplete task

Conclusion

Markdown is a powerful yet simple tool for formatting text. Its ease of use makes it a favorite among writers, developers, and anyone who needs to create well-structured documents. By mastering the basics covered in this guide, you'll be able to write in Markdown with confidence and efficiency.

This blog post was generated using ChatGPT