# 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.

:gem: 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

- Awesome Markdown
  - Contents
  - CMS / Blogs
  - Libraries
    - C
    - Java
    - JavaScript
    - Perl
    - PHP
    - Python
    - Ruby
  - Tools
    - Converters
    - Editors
    - Linters
    - Miscellaneous
    - Presentations
  - Services
  - Resources
    - Documentation
    - Tutorials
  - License

## 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.
- Pelican - Static site generator that requires no database or server-side logic.
- Svbtle - Blogging platform designed to help you think.
- Vuepress - Minimalistic Vue-powered static site generator.
- Laravel CommonMark Blog - Static-generator to use with Laravel. Utilizes CommonMark and FrontMatter and publishes directly into the `public`-folder.

## Libraries

> Libraries for rendering Markdown documents.

### C

- cmark - CommonMark parsing and rendering library and program in 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 :gem: John Gruber’s original Markdown library.

### PHP

- commonmark - Highly-extensible PHP Markdown parser which fully supports the CommonMark and GFM specs.
- parsedown - Better Markdown Parser in PHP.
- php-markdown - Parser for Markdown and Markdown Extra derived from the original Markdown.pl by John Gruber.

### Python

- markdown-it-py - Markdown parser, done right. 100% CommonMark support, extensions, syntax plugins & high speed. Now in Python!
- markdown2 - Fast and complete implementation of Markdown in Python.
- Mistune - The fastest Markdown parser in pure Python with renderer feature.
- PyMdown Extensions - A collection of extensions for Python Markdown.
- 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.
- clipboard2markdown - Website to paste content and get a markdown version. Works on any modern browser with JavaScript.

### 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. :gem: Really simple editor!
- Let’s Markdown! - An online real-time collaborative markdown editor built on Rust.
- 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.
- Notable - The Markdown-based note-taking app that doesn’t suck.
- Boostnote - A markdown editor for developers.
- Trilium Notes - A hierarchical note taking application with focus on building large personal knowledge bases.
- Joplin - An open source note taking and to-do application with synchronisation capabilities.
- Visual Studio Code - An open source code editor with built-in markdown preview and many markdown extensions.
- Quiver - A notebook built for programmers.
- Bear - A beautiful, flexible writing app for crafting notes and prose.
- Obsidian - Notebook editor with Mermaid support
- Bangle.io - A Notion like note taking webapp where data is saved in Markdown format locally.

### 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.
- markdownlint - Markdown linting and style checking for Visual Studio Code.

### Miscellaneous

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

- Dillinger - Dillinger is a cloud-enabled, mobile-ready, offline-storage, AngularJS powered HTML5 Markdown editor.
- GitDown – GitHub’s Markdown preprocessor. :octocat:
- 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. :gem: Markdown notes with encryption!
- Markable.in - Remarkable Markdown Editor.
- markcat - Markdown files terminal viewer. :gem: `cat` with Markdown highlight.
- Markdown Magic - Automatically format markdown files and sync external docs/src code
- Markdown Tables Generator - Visual Markdown table builder with CSV importing support.
- mdformat - CommonMark compliant Markdown formatter
- remark - Markdown processor powered by plugins
- Socrates - Serveless realtime Markdown editor and viewer, etherpad-like.
- termd - Markdown renderer for the terminal with syntax highlighting.

### Presentations

> Create and edit your slides presentations with Markdown.

- gitpitch - Markdown Presentations For Everyone on GitHub, GitLab, Bitbucket, GitBucket, Gitea, and Gogs.
- hacker-slides - Minimal UI for building presentation slides from markdown.
- Marp - Markdown presentation ecosystem. :gem: CLI, Web, IDE plugin and more to convert Markdown into various formats
- mdp - Command-line based Markdown presentation tool. :gem: 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.
- reveal.js - Open source HTML presentation framework with Markdown support

## 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 :gem: 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 :gem: 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.

markdown.md Github