Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Gedit Markdown Preview

This is a plugin for the Gedit text editor, previewing .md files in the side pane (F9) or the bottom (Ctrl+F9) pane.


  • show a preview of a file
  • dynamically update the preview
  • zoom in or out on the preview
  • search in the preview
  • open links and images

This works for Markdown files, and HTML files.


You can print the preview, or export it:

  • if pandoc is installed on your system, you can export to any format it supports
    • a stylesheet can be applied to most file formats
    • be careful if you want to export to PDF: pandoc doesn't come with all necessary dependencies by default
  • if only python3-markdown is installed, you can export to HTML


With the preview in the side pane, menu opened With the preview in the bottom pane, searching
With the preview in the side pane, menu opened With the preview in the bottom pane, searching



  • For Arch Linux and its derivatives: the AUR package is named gedit-plugin-markdown_preview.

Even if you install the plugin with a package manager, you may like to read the following sections, since installing optional dependencies will enable new features of the plugin.

Manual installation

  1. Dependencies. Be sure to have these packages before installing the plugin:
  • gedit (≥3.22)
  • gir1.2-webkit2-4.0
  • python3-markdown or pandoc
  • if you want to export to PDF with pandoc, you'll need at least pdflatex and lmodern. Those are provided by texlive packages whose names vary depending on the distribution. Warning: the version provided by Debian is sadly broken (some error message about xcolor.sty).
  1. Download the ZIP of the last release.
  2. Extract the archive.
  3. Open the project's folder in a terminal.
  4. Run ./ — it can be executed as root (system-wide installation) or as a normal user (user-wide installation).


The plugin is now installed and has to be enabled:

  • Open Gedit's preferences.
  • Go to the "Plugins" tab.
  • Enable the "Markdown Preview" plugin.


The plugin's options can be accessed…

  • from Gedit's preferences → Plugins → Markdown preview → Preferences
  • or with the plugin's "3-dots menu" → Options

General options

  • Position of the preview (left side or bottom)
  • If you want the plugin to understand relative paths (for links and pictures). This is not recommended if you use special characters in filenames (some versions of WebKit2GTK can't load URIs with special characters for some reason)

Rendering options

The preview can be generated with pandoc or python-markdown.

A stylesheet (CSS file) can be applied to the preview (markdown files only, it will not be loaded for HTML files).

Options with python-markdown

A set of extensions is provided natively with python-markdown. You can enable or disable them depending on your needs.

Great third-party extensions exist too, and once installed they can be added manually to the list.

Available languages

  • English
  • French
  • Dutch