Write Smarter, Not Harder: A Beginner’s Guide to Markdown

Write Smarter, Not Harder: A Beginner’s Guide to Markdown

When it comes to creating content online, Markdown is a popular and powerful tool that can make formatting text easier and more efficient. This lightweight language can be used to create everything from simple notes and emails to full-blown websites, or assist with git CI/CD and blog posts.

What is Markdown?

Markdown is a plain text formatting syntax created by John Gruber and Aaron Swartz in 2004. It was designed to be easy to read and write, with a simple set of rules that can be applied to text in any text editor.

The beauty of Markdown lies in its simplicity. You don’t need any special software or tools to use it – all you need is a basic text editor like Notepad or an IDE like Visual Studio Code. And because it’s plain text, it’s easy to share and collaborate on Markdown documents.

Why use Markdown?

There are several reasons why Markdown is a popular choice for formatting text:

  • Easy to Learn: One of the biggest advantages of Markdown is its ease of use. The syntax is simple and intuitive, and can be learned in just a few minutes. Unlike other markup languages, such as HTML, which requires a significant amount of coding knowledge, Markdown can be used by anyone regardless of their technical background.
  • Platform Agnostic: Markdown is platform agnostic, meaning that it can be used on any platform or device. Whether you’re using a desktop computer, a laptop, a tablet, or a smartphone, you can create and edit Markdown documents without the need for any specific software. This makes it a highly versatile tool that can be used in a wide range of contexts.
  • Efficiency: Markdown is designed to be a highly efficient language. With its simple syntax and easy-to-learn structure, users can quickly and easily format text without the need for complex formatting tools or software. This makes it a great choice for writers, developers, and other professionals who need to create well-structured documents quickly and efficiently.
  • Integration: Markdown can be easily integrated with other tools and applications, such as GitHub, Slack, and WordPress. This makes it an ideal choice for developers who need to write code and documentation in the same document, or for bloggers who want to easily publish formatted content on their website.

Markdown and Git

Markdown is particularly useful in the context of Git and README files. When creating a repository on Git, it’s common to include a README file that provides a brief introduction to the project, as well as instructions on how to use it. Markdown is a great tool to use for writing README files, as it allows developers to quickly and easily format the text in a readable and consistent way.

Additionally, because Markdown files are plain text files, they can be easily version-controlled using Git, meaning that changes to the README file can be tracked over time. This can be particularly useful when collaborating with other developers, as it allows everyone to see how the README has changed and what updates have been made.

How does Markdown work?

Markdown uses a set of simple symbols and characters to indicate formatting. For example, putting two asterisks around a word or phrase will make it bold, while putting one asterisk around it will make it italic.

Here are a few examples of Markdown formatting:

  • Bold text: **This text is bold**
  • Italic text: *This text is italic*
  • Heading 1: # This is Heading 1
  • Heading 2: ## This is Heading 2
  • Heading 3: ### This is Heading 3
  • Lists:
    • Unordered:
      • This is an unordered list item
      • – This is another undordered
    • Ordered:
      • 1. This is an ordered list item
      • 2. This is another an ordered list item

Or as written directly in markdown:

**This text is bold**
*This text is italic*

# This is a Heading 1
## This is a Heading 2
### This is a Heading 3

Unordered lists: 
- This is an unordered list item
- This is another unordered list item
Ordered lists:
1. This is an ordered list item
2. This is another ordered list item

Code Blocks

If you need to include code in your Markdown document, you can use code blocks. Code blocks are formatted with either three backticks (“`) or three tildes (~~~) before and after the code. For example:

def greet(name):
    print(f"Hello, {name}!")```

This will produce a code block that looks like this:

def greet(name):
    print(f"Hello, {name}!")


Markdown also supports tables, which can be useful for presenting data in a clear and organized way. To create a table, you use pipes (|) to separate columns and hyphens (-) to create a header row. For example:

| Name | Age | Occupation |
| John | 32  | Engineer   |
| Jane | 28  | Designer   |

This will produce a table that looks like this:


Links and Images

Markdown also supports adding links and images to your document. To add a link, you use square brackets [] to indicate the link text and parentheses () to indicate the URL. For example:

[Visit Mindcore](https://www.mindcore.dk)

This will produce a link that looks like this: Visit Mindcore

To add an image, you use similar syntax, but include an exclamation mark (!) before the square brackets. For example:

[alt text](image URL)


Finally, Markdown also supports adding emojis to your document. To add an emoji, you use a colon (:) followed by the emoji name and another colon. For example:


This will produce a smiley face emoji: 😄


If you need to add footnotes to your document, Markdown supports this feature as well. To add a footnote, you use square brackets [] followed by a caret (^) and the footnote text in parentheses (). For example:

Here is some text with a footnote[^1].

[^1]: This is the footnote text.

This will produce a superscript number after the text with a corresponding footnote at the bottom of the document.

Task Lists

Markdown also supports task lists, which can be useful for creating to-do lists or tracking progress. To create a task list, you use a hyphen (-) or an asterisk (*) followed by a space, then square brackets [] with an x inside to indicate a completed task, or a space inside to indicate an incomplete task. For example:

- [x] Complete task 1
- [ ] Incomplete task 2

This will produce a task list with a checkbox next to each task, indicating whether it is complete or not.

Definition Lists

If you need to define terms or concepts in your document, Markdown supports definition lists. To create a definition list, you use a term followed by a colon (:) on one line, and the definition on the next line. For example:

Term 1:
Definition 1

Term 2:
Definition 2

Blockquotes with Multiple Paragraphs

Markdown also supports blockquotes, which are useful for quoting text from other sources. If you need to include multiple paragraphs in a blockquote, you can use the greater than sign (>) at the beginning of each paragraph. For example:

> Here is some text in a blockquote.
> This is another paragraph in the same blockquote.

This will produce a blockquote with multiple paragraphs.


Markdown is a simple and powerful language for formatting text, with a wide range of uses and benefits. Whether you’re a blogger, a developer, or just someone who needs to format text quickly and efficiently, Markdown is definitely worth learning. So why not give it a try today?

If you are interested in getting in more detail with markdown, and excellent source can be found HERE.

Table of Contents

Share this post
Search blog posts
Modern Workplace consultant and a Microsoft MVP in Enterprise Mobility.
Modern Workplace consultant and a Microsoft MVP in Windows and Devices for IT.

Infrastructure architect with focus on Modern Workplace and Microsoft 365 security.

Cloud & security specialist with focus on Microsoft backend products and cloud technologies.

Cloud & security specialist with focus on Microsoft 365.

Cloud & Security Specialist, with a passion for all things Cybersecurity

Cloud and infrastructure security specialist with background in networking.

Infrastructure architect with focus on design, implementation, migration and consolidation.

Infrastructure consultant with focus on cloud solutions in Office365 and Azure.

follow us in feedly

Follow on SoMe