Beginner Guide to Markdown Language

About MarkDown Language

Markdown is a lightweight markup language that simplifies the workflow of web writers. It was created in 2004 by John Gruber with contributions and feedback from Aaron Swartz. Markdown was described by John Gruber as: “A text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).” Markdown is two different things:

  • Simple syntax to create documents in plain text
  • A software tool is written in Perl that converts the plain text formatting to HTML

Running the Markdown on Local Personal Computer

Downloading Perl

Downloading Perl according to your requirements

Downloading Markdown

Download Markdown from official website

Running Markdown

The Perl script is not too complicated to use. Again, in our command-line interface, we run Perl that takes two arguments: the path of the Markdown script that we just downloaded and the path of the Markdown file that we want convert.


Markdown will process the Markdown file; the resulting output after running the script is the HTML code shown in the terminal. To save this output, we redirect the standard output to an HTML file:

perl > output-file.html

Creating your first Markdown document

Inserting Paragraph

A paragraph, divided into two lines.

The preceding code will produce: <p>A paragraph,
divided into two lines.</p>

A paragraph Another paragraph, separated by a new line.

The preceding code will produce: <p>A paragraph</p>
<p>Another paragraph, separated by a new line.</p>

A sentence, with a line break.

The preceding code will produce: <p>A sentence, <br /> with a line break</p>

Inserting Headers

`Header 1`
` `Header 2`
` — — — — `

The preceding code will produce:
<h1>Header 1</h1>
<h2>Header 2</h2>

Atx style

# Header 1
## Header 2
### Header 3
#### Header 4
##### Header 5
###### Header 6
The preceding code will produce:
<h1>Header 1</h1>
<h2>Header 2</h2>
<h3>Header 3</h3>
<h4>Header 4</h4>
<h5>Header 5</h5>
<h6>Header 6</h6>

Wrapping Up

Markdown is a simple and beautiful language to create Github Pages and Documents. Following Cheat sheets are available for full Markdown Documentation

Cheat Sheet 1

Instant Markdown

Cheat Sheet 2

Markdown Here




DevOps Engineer - Author

Love podcasts or audiobooks? Learn on the go with our new app.

Recommended from Medium

Learn Steem Blockchain using Python | Part 1

Trying My Best

Zeppelin in Kubernetes

Python Visual Studio- Learn How To Make Your First Python Program

Create a quick WordPress form with a welcome email — without a plugin

Why should you try Linux?

First Automation Test on Android with Java

Utilizing ERC-777 operators.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Adil Shehzad

Adil Shehzad

DevOps Engineer - Author

More from Medium

Beginner’s guide to using diff and patch

SSH Key for GitHub (How-To)

Learn SQL with a different approach!

Get your code on GitHub with Git — a beginners guide