Layman’s Guide to Markdown on Mattermost

One of the biggest challenges with text-based communication is that oftentimes context, emotions, and intentions can get lost in translation. 

On the other hand, when we speak to one another, we have the advantage of inflection, tone, and body language to help convey our points effectively.

Historically, adding context to text-based communications involved writing HTML code—something that was a bit too complicated for the average internet user.

To solve this problem, Markdown—a lightweight markup language—emerged in 2004. 

Thanks to Markdown, formatting text is incredibly easy. If you want text to render in italics, simply add an asterisk on either side of the language in question (e.g., *hello* renders as hello).

Markdown on Mattermost

In response to community feedback and in an effort to make it easier for teams to communicate with colleagues across the world, we added Markdown support to Mattermost in 2015. 

(Coincidentally, Slack did the same thing the following week.)

Are you new to using Markdown on Mattermost? 

What follows is a brief overview of some of the ways you can use Markdown to communicate more effectively on Mattermost.

1. Text style

InputOutput
_Mattermost_Mattermost
**DevOps**DevOps
**_open source_**open source
~~legacy tools~~legacy tools

2. Links

InputOutput
[Mattermost](https://mattermost.com) Mattermost

3. Emojis

4. Lists

5. In-line code

InputOutput
`monospace`monospace

6. Headings

InputOutput
## Large Heading

Large Heading

### Smaller Heading

Smaller Heading

#### Even Smaller Heading

Even Smaller Heading

7. Block quotes

You don’t need to memorize all of these commands, either.

Just bookmark this handy doc, refer to it when you’re in a pinch, and get ready to start communicating with more precision on Mattermost. There, you can also learn how to use Markdown to make code snippets, math formulas, and tables appear in special formats, too.

Using Markdown to format text is one of the features our team uses to be more productive on Mattermost.

If you want to learn more ways to increase your proficiency on Mattermost, check out this blog post that highlights our 10 favorite productivity hacks.

Share this article:

Stu Doherty

Stu Doherty is a Senior Customer Success Manager at Mattermost, Inc. Prior to joining Mattermost, Stu held several different customer success and software engineering roles. Most recently, he worked as a customer success and growth consultant at Meya.ai, a senior manager of technology delivery and partner management at TD, and a VP of customer success at Nulogy. Stu holds a bachelor of science degree in systems design engineering from the University of Waterloo.

To get future blog posts to your inbox, subscribe below.

Compare Mattermost vs. Slack's Total Cost of Ownership.Learn more