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.
Previewing
- 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, HTML, and SVG files.
Exporting
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
Editing assistance
- insert an image in your file
- insert markdown tags in your text from the right-click menu
Screenshots
| With the preview in the side pane, menu opened |
With the preview in the bottom pane, searching |
 |
 |
Installation
Packages
- 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
- Dependencies. Be sure to have these packages before installing the plugin:
gedit (≥3.22)gir1.2-webkit2-4.0python3-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).
libglib2.0-bin (needed for the installation script only). This is the
package name on debian-based distros, it may differ on your system.
- Download the ZIP of the last release.
- Extract the archive.
- Open the project’s folder in a terminal.
- Run
./install.sh — it can be executed as root (system-wide installation) or
as a normal user (user-wide installation).
Activation
The plugin is now installed and has to be enabled:
- Open Gedit’s preferences.
- Go to the “Plugins” tab.
- Enable the “Markdown Preview” plugin.
Configuration
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
评论