Awesome Markdown

A curated list of delightful Markdown stuff.

Markdown is a markup language created by John Gruber in collaboration with Aaron Swartz. It was designed to be easily converted to HTML and has been extended into different types of implementations.

Please read the contribution guidelines before contributing.

💎 means really awesome/useful.
means that it's webapp/webservice.
means that runs on Android.
means that runs on iOS.
means that runs on macOS.
means that runs on Linux.
means that runs on Windows.

Contents

• CMS / Blogs
• Libraries
  • C
  • Java
  • JavaScript
  • Perl
  • PHP
  • Python
  • Ruby
• Tools
  • Converters
  • Editors
  • Linters
  • Miscellaneous
  • Presentations
• Services
• Resources
  • Documentation
  • Tutorials

CMS / Blogs

CMS or Blogs which support Markdown by default.

• Ghost - Publishing platform for professional bloggers.
• Grav - Modern Flat-File CMS.
• Hexo - A fast, simple & powerful blog framework
• Hugo - Fast & Modern Static Website Engine.
• Jekyll - Transform your plain text into static websites and blogs.
• Svbtle - Blogging platform designed to help you think.

Libraries

Libraries for rendering Markdown documents.

C

• Hoedown - Standards compliant, fast, secure Markdown processing library in C (Sundown fork).
• peg-markdown - An implementation of Markdown in C, using a PEG grammar.
• Sundown - Standards compliant, fast, secure Markdown processing library in C.

Java

• commonmark-java - Java implementation of CommonMark, a specification of the Markdown format.
• flexmark-java - Java Implementation of Markdown parser with source level AST.
• pegdown - A pure-Java Markdown processor based on a parboiled PEG parser supporting a number of extensions.

JavaScript

• markdown-it - Markdown parser, done right. 100% CommonMark support, extensions, syntax plugins & high speed.
• markdown-js - Yet another Markdown parser, this time for JavaScript.
• marked - Full-featured Markdown parser and compiler, written in JavaScript. Built for speed.
• mmarkdown - Interpret mmd fenced code blocks in a markdown file and generate a cooler version of it.
• Showdown - Showdown is a JavaScript Markdown to HTML converter, based on the original works by John Gruber.
• Snarkdown - Snarkdown is a dead simple 1kb Markdown parser.

Perl

• Markdown.pl 💎 John Gruber's original Markdown library.

PHP

• parsedown - Better Markdown Parser in PHP.
• php-markdown - Parser for Markdown and Markdown Extra derived from the original Markdown.pl by John Gruber.

Python

• markdown2 - Fast and complete implementation of Markdown in Python.
• Mistune - The fastest Markdown parser in pure Python with renderer feature.
• Python-Markdown - Python implementation of John Gruber's Markdown.

Ruby

• kramdown - kramdown is a fast, pure Ruby Markdown superset converter, using a strict syntax definition and supporting several common extensions.
• Redcarpet - Redcarpet is a Ruby library for Markdown processing that smells like butterflies and popcorn.

Tools

Converters

Convert Markdown to other formats and vice versa.

• csvtomd - Convert your CSV files into Markdown tables.
• Dimer Markdown - converts Markdown to HTML or to JSON
• HTML To Markdown for PHP - Convert HTML to Markdown with PHP.
• markdown-pdf - Markdown to PDF converter.
• Markdown to PDF - Simple and useful website for converting Markdown to PDF.
• Pandoc - Universal document converter.
• Torsimany - Translate format-independent JSON to stylish, human-readable Markdown.
• turndown - HTML to Markdown converter written in JavaScript.
• yamp - Easy-to-use cli toolbox for markdown-related task.

Editors

Edit and save your Markdown documents.

• Abricotine - Lightweight markdown editor built with Electron with built-in realtime preview.
• Caret - Markdown Editor for Mac and PC.
• iA Writer - iA Writer is designed to provide the best writing experience on Mac OS, iOS and Android. 💎 Really simple editor!
• Markdownify - A minimal Markdown Editor desktop app.
• MarkRight - Minimalistic github flavored Markdown editor.
• Mark Text - Next generation Markdown editor (built with Electron).
• PileMd - Markdown Note App.
• StackEdit - In-browser markdown editor.
• TOAST UI Editor - Extensible GFM Markdown WYSIWYG Editor
• Typora - A minimal Markdown editor.

Linters

Flag and standarize your Markdown documents.

• Markdown Lint Tool - Tool to check Markdown files and flag style issues.
• Markdownlint - Node.js style checker and lint tool for Markdown/CommonMark files.
• remark-lint - Markdown code style linter.
• textlint - Pluggable linting tool for text and markdown.

Miscellaneous

Tools which let you edit, convert, export, et al. your Markdown documents.

• Classeur - Classeur is a new platform to write simple notes as well as technical documents and blogs.
• Dillinger - Dillinger is a cloud-enabled, mobile-ready, offline-storage, AngularJS powered HTML5 Markdown editor.
• GitDown – GitHub's Markdown preprocessor.
• HackMD - HackMD lets you create realtime collaborative Markdown notes on all platforms.
• Laverna - Laverna is a JavaScript note taking application with Markdown editor and encryption support. 💎 Markdown notes with encryption!
• Markable.in - Remarkable Markdown Editor.
• markcat - Markdown files terminal viewer. 💎 cat with Markdown highlight.
• Markdown Tables Generator - Visual Markdown table builder with CSV importing support.
• remark - Markdown processor powered by plugins
• Socrates - Serveless realtime Markdown editor and viewer, etherpad-like.
• Markdown Magic - Automatically format markdown files and sync external docs/src code

Presentations

Create and edit your slides presentations with Markdown.

• gitpitch - Markdown Presentations For Everyone on GitHub, GitLab, Bitbucket, GitBucket, Gitea, and Gogs.
• Marp - Markdown Presentation Writer. 💎 Like PowerPoint but with Markdown!
• mdp - Command-line based Markdown presentation tool. 💎 Like PowerPoint and Vim but with Markdown!
• remark - A simple, in-browser, Markdown-driven slideshow tool targeted at people who know their way around HTML and CSS.

Services

Different services which take advantage of Markdown.

• Daux.io - Daux.io is an documentation generator that uses a simple folder structure and Markdown files to create custom documentation on the fly.
• Dimer - Dimer generates a clean and beautiful documentation website from Markdown.
• GitBook - GitBook is a modern publishing toolchain. Making both writing and collaboration easy.
• GitPrint - Easily print GitHub Markdown.

Resources

Documentation

Documentation and useful information about Markdown.

• CommonMark - Strongly defined, highly compatible specification of Markdown.
• GitHub Flavored Markdown Specifications - The formal spec for GitHub's Markdown, based on CommonMark.
• Original Specifications 💎 The place to start with Markdown!
• Pandoc’s Markdown - Pandoc has its own, powerful markdown implementation. It consists of several addional extensions.
• ScholarlyMarkdown - ScholarlyMarkdown is a syntax/standard/best-practice of scholarly and academic communication that is web-first, semantic XML-second, and LaTeX/Word a close third.
• Stack Overflow Markdown Documentation (archived) - Well organized Markdown documentation.
• Stack Overflow Markdown Questions - Highest voted Markdown questions on Stack Overflow.
• The text/markdown Media Type (RFC7763) - This document registers the text/markdown media type for use with Markdown, a family of plain-text formatting syntaxes.
• Wikipedia Article

Tutorials

Useful links and tutorials.

• GitHub's Mastering Markdown
• how-to-markdown - This workshopper will teach you how to use Markdown.
• Interactive Markdown Tutorial
• Markdown Cheatsheet 💎 Where to look when you don't remember the syntax!
• Markdown Guide - A concise, barebones guide to Markdown.

Icon pack by Icons8

License

To the extent possible under law, Joaquín Serna has waived all copyright and related or neighboring rights to this work.