Joplin Basics – How to use simple Markdown in the Joplin note taking app

Joplin is an open source note taking app that is growing in popularity. Joplin was originally positioned as an open source alternative to the well-known Evernote. Joplin has many powerful functionalities and can be further adapted and expanded to your own needs via the now large selection of extensions. Joplin is a beautiful and powerful application, but people who are just starting out with Joplin sometimes have to get used to the different options for creating content. One of those ways is through the Markdown markup language. In this article, as part of my Joplin Basics tutorial series, I provide more insight into how to use some simple Markdown syntax in the Joplin note taking app.

Content of the article

  1. What is Joplin
  2. What is Markdown
  3. Markdown in Joplin
  4. Headings in Markdown
  5. Basic text formatting in Markdown
  6. Lists in Markdown
  7. Blockquotes in Markdown
  8. Tables in Markdown
  9. Horizontal rule in Markdown
  10. Creating checkboxes in Markdown
  11. Creating links in Markdown
  12. Code block formatting in Markdown

What is Joplin

Joplin is a powerful open source, platform-independent, subscription-free, and cost-free note-taking, and note-making tool, available for all operating systems, but also on all mobile devices, with sync capabilities with various cloud services including Nextcloud, Dropbox, OneDrive, WebDAV, or your local file system. Joplin offers an extensive set of possibilities, whatever you can imagine you need for capturing various kinds of notes. Think about a web clipper for Firefox and Chrome, note history (revisions), support for notes, to-dos, tags and notebooks, sort notes by multiple criteria, like title, and updated time, markdown support, multimedia notes, like images, videos, PDFs and audio files, and collaboration options.

If you want to find out more about what Joplin has to offer and how to get it, go to the following website:

You can find all information on how to download and install Joplin here:

What is Markdown

Many people prefer a direct and visual interaction between formatting their content and the functionality to make formatting possible via for example buttons in a graphical user interface. We also call this WYSIWYG (What You See is What You Get). In other words, if one wants to make a sentence or word bold, one naturally selects the sentence or word and presses a button in the menu that converts the selection to bold. The same goes for italic, etc. But in addition to this visual method of content manipulation, the Joplin note taking app also offers another method, namely Markdown. And according to many, Markdown fits very well with note taking, for example, because it can be much faster than clicking on different buttons. Instead of continuously reaching for your mouse, you can keep your fingers on the keyboard to format your content. In addition to Joplin, there are several other note taking applications that support Markdown.

Markdown offers you the opportunity to format your content in a very direct way via markup notation without using the mouse. For example, by typing “### This is a Heading 3”, you can automatically convert this text to a Heading 3. Another example is “**here an example of bold text**”, which automatically converts the text to bold. And the nice thing in Joplin is the option to split the screen so you can see the markdown based text and the actual formatted text next to each other.

These are just a few simple examples. With the Markdown language, creating very complex constructions, such as designing scientific formulas is possible.

So let’s see what we can do with Markdown in Joplin.

Markdown in Joplin

Markdown is very comprehensive and covers a large number of formatting use cases. In this article we focus on the relatively simple Markdown options for basic formatting. In a separate future article I will pay more attention to the more complex Markdown, such as diagrams, chemical equations and mathematical formulas.

Headings in Markdown

Below you find an overview of Heading formatting options in Markdown…

Because this article on Joplin has a further reach than Linux only, you can read the remainder of my article “Joplin Basics – How to use simple Markdown in the Joplin note taking app” on my other website,

Have a look at my latest book on Linux, in Paperback or Kindle format.

For more info on my book click here.

When you want to buy the book click on the image below.

If you appreciate what I do on this website…,

User Avatar

About John Been

Hi there! My name is John Been. At the moment I work as a senior solution engineer for a large financial institution, but in my free time, I am the owner of,, and author of my first book "Linux for the rest of us". I have a broad insight and user experience in everything related to information technology and I believe I can communicate about it with some fun and knowledge and skills.

View all posts by John Been →