markdown-modern

Modern visual styling for Markdown buffers in Emacs.

markdown-modern renders Markdown inline — headings, emphasis, code, tables, images — using text properties and overlays, in the spirit of org-modern. It reveals the raw markup of the element under the cursor for editing, rather than showing raw syntax or a split-pane preview.

markdown-modern is a fork of mark-graf by Marc Ansset.

Features

markdown-modern's own rendering and editing:

• Inline rendering — headings, bold, italic, inline code, links and images shown in place, via text properties and overlays
• Reveal-at-point editing — the element under the cursor shows its raw markup (styling preserved) for editing, and re-renders when you move away; a single view mode, no source/rendered toggle
• Viewport-driven — built on jit-lock, so rendering cost is independent of file size (see Performance)
• GFM constructs — tables, task lists, fenced code blocks, strikethrough, blockquotes, lists, horizontal rules
• Mermaid diagrams — rendered inline by a built-in, pure-Elisp SVG renderer (no Node or external CLI)
• LaTeX math — inline and display math via a built-in LaTeX → Unicode converter
• HTML export — built in, with no external dependencies

Wired up from Emacs built-ins or external tools:

• Code-block syntax highlighting — uses the language's own major mode (python-mode, rust-ts-mode, …); requires that mode to be installed
• Inline image display — Emacs's built-in image support, with scaling
• SVG math — optional, via the external tex2svg (MathJax-node)
• PDF / DOCX / other export — optional, via the external pandoc

Keybindings mirror markdown-mode's C-c C-s … conventions for familiarity — though markdown-modern is its own major mode (derived from text-mode), not built on markdown-mode.

Performance

Rendering is driven by jit-lock, so only the visible region is rendered — open and scroll cost is independent of file size, not proportional to it. On a 25,000-line (~600 KB) Markdown file, rendering a screenful takes about 3 ms with the tree-sitter parser, and reveal-at-point is sub-millisecond. Run make bench to measure on your machine.

Requirements

• Emacs 30.1 or later

Optional Dependencies

• pandoc - For PDF/DOCX export

Installation

markdown-modern is not on MELPA; install it directly from this repository.

With package-vc-install (Emacs 29+, recommended)

M-x package-vc-install RET https://github.com/rjprins/markdown-modern RET

Or in your init file:

(package-vc-install "https://github.com/rjprins/markdown-modern")

With use-package (Emacs 30+):

(use-package markdown-modern
  :vc (:url "https://github.com/rjprins/markdown-modern"))

Manual

(add-to-list 'load-path "/path/to/markdown-modern/lisp")
(require 'markdown-modern)

Usage

Enable markdown-modern for markdown files by adding to your init file:

(add-to-list 'auto-mode-alist '("\\.md\\'" . markdown-modern-mode))

Or activate manually with M-x markdown-modern-mode in any markdown buffer.

Quick Start

Editing Model

markdown-modern has a single view mode. Markdown is always rendered inline; when the cursor enters the scope of a markup element, that element's raw markup is revealed so you can edit it in place, and re-rendered once the cursor leaves:

• On a heading line, the # markers appear (at the heading's size).
• Inside (or right next to) emphasis, a code span, or a link, that element's delimiters appear.
• On a list item or blockquote, the leading marker (- , 1. , > ) appears.
• Inside a fenced code block or table, the raw block is shown.

Task checkboxes are the exception: they are treated as interactive widgets, not markup to reveal. Point on a checkbox keeps the rendered ☐/☑; SPC toggles it, and Backspace/Delete on it removes the checkbox, leaving a plain list item.

Plain prose is never disturbed, so moving the cursor through ordinary text does no work. There is no source/rendered toggle to manage.

You can also reveal the element at point on demand with markdown-modern-toggle-element-at-point (C-c C-v e).

Navigation

Lists

Tables

Export

;; Built-in HTML export (no dependencies)
M-x markdown-modern-export-html

;; Preview in browser
M-x markdown-modern-preview-html

;; Export via Pandoc (requires pandoc)
M-x markdown-modern-export-pdf
M-x markdown-modern-export-docx

Customization

All options are under M-x customize-group RET markdown-modern RET. The faces (markdown-modern-heading-1 … -6, -bold, -italic, -inline-code, -code-block, -table, …) are under markdown-modern-faces.

Appearance

Reading width

Code blocks

Images & diagrams

Math

Export

Example configuration

(use-package markdown-modern
  :vc (:url "https://github.com/rjprins/markdown-modern")
  :mode ("\\.md\\'" "\\.markdown\\'")
  :custom
  ;; Constrain the reading width (off by default):
  (markdown-modern-manage-text-width t)
  (markdown-modern-text-width 100)
  :config
  (set-face-attribute 'markdown-modern-heading-1 nil :foreground "#2aa198"))

Keybinding Reference

Style Insertion (C-c C-s prefix)

Headings (C-c C-t prefix)

Reveal (C-c C-v prefix)

Export (C-c C-e prefix)

Known Limitations

• Setext-style headings (underlines) are not supported
• Math rendering requires external tools for SVG output
• Some complex nested structures may not render perfectly

License

GPL-3.0-or-later

Credits

markdown-modern is a fork of mark-graf by Marc Ansset; thanks for the original work.

Inspired by:

• org-modern - Modern org-mode styling
• markdown-mode - The standard Emacs markdown mode