Markdown Navigator

Compatible with: IntelliJ IDEA PhpStorm WebStorm PyCharm RubyMine AppCode CLion Gogland DataGrip Rider Android Studio
2 007 812


Markdown Navigator 2.0

Markdown language support for IntelliJ platform

A Markdown plugin with GFM and a matching preview style.

Document with pleasure!

Work with Markdown files like you do with other languages in the IDE, by getting full support for:

  • completions to reduce typing
    • link address ⇐ files
    • ref anchors ⇐ headings
    • footnote refs ⇐ footnotes
    • ref links/ref images ⇐ references
    • link text ⇐ ref anchor/link address
  • error and warning annotations to help catch mistakes early
  • intention actions for fast results with less effort
  • wrap on typing to keep it nicely formatted as you edit
  • formatting to change format with a key stroke
  • navigation and find usages to find references without effort
  • refactoring of all referencing elements: to keep it all in sync while evolving
    • files ⟺ links
    • headings ⟺ ref anchors
    • footnotes ⟺ footnote refs
    • references ⟺ ref links/ref images
  • GitHub style rendering that you are used to, out of the box
  • Fast typing response for distraction free editing
  • Fully customizable to adjust to your project’s needs and your preferences
  • Copy Markdown as JIRA, YouTrack or HTML formatted text
  • Convert HTML content to Markdown by pasting it into a Markdown document.
  • Export as HTML or PDF to share with others
  • Paste images from clipboard into markdown documents for fast screenshot based documentation
  • Split Editor
  • Fast typing response in large files
  • HTML text preview and export
  • Soft Wrap on right margin
  • Format with code style:
    • Multi-byte support with mixed character width
    • Table justification
    • Wrap on typing auto format of element
    • Renumbering of list items
  • Bidirectional Source and Preview synchronization
    • Scrolls preview to show source element at caret
    • Moves caret to source line of element clicked in preview
  • Also does completions, refactoring, validation, language injections, code folding
  • Fully configurable by project with support for scopes
  • Understands GitHub wiki nuances
  • Conversion between HTML and Markdown
  • Export to HTML or PDF
  • Paste Image into Markdown documents with basic image transformations:
    • crop image
    • round corners
    • add border
    • transparent color

Download plugin

Recent change notes

2.3.4 - Bug Fix & Enhancement Release
  • Fix: incorrect parsing in GitHub Doc compatibility mode, #401, Parser fails if code chunks contain markdown header elements
  • Add: Link Format option to Paste Image and Copy Image dialogs
    • Page Relative
    • Repo Relative (/...)
    • Absolute (http://)
    • Absolute (file://)


  • Add: Link Format option to drag & drop non-image files if copy dragging (Ctrl on Linux/Windows, ⌥ on OS X) dialog is presented before the first file link is created and the same format is used for the rest of the files.
  • Add: File drag and drop into markdown document to create links, image files create image links the rest create inline links. Each file link will be added as a separately undoable command.

    If copy dragging images (Ctrl on Linux/Windows, ⌥ on OS X) then for image files the Copy Image dialog will open (like paste image) that will allow you to modify the image and choose the location where to store the copy.

  • Fix: #394, NullPointerException in MarkdownPasteHandler.doExecute()
  • Fix: references to images in the project from wiki home page with file://, http:// or https:// format would show as unresolved and conversion. Also affected conversion of link format on wiki home page.
Version 2.3.3

Bug and compatibility fixes you can find in Version Notes.

  • Paste Images from clipboard directly into Markdown documents to inserts an image link or update links and save PNG image file thanks image utils library from holgerbrandl/pasteimages

    • caret context ops: insert image link, replace link, replace link target, replace image file content
    • image processing options with preview:
      • crop left, right, top, bottom settings
      • scale image 10% to 200% with interpolation options:nearest neighbour, bilinear, bicubic
      • change color (with margin of tolerance) to transparent
      • round corners with corner radius setting
      • add border with border width option

    Screen Shot Paste Image

  • PDF export action, menu and toolbar item added

  • GitHub Collapse Markdown script, which converts headings in the document to collapsible sections in preview, with state persistence for initializing the open/close state of headings. Now collapsed heading are preserved between page refreshes and when opening markdown files.

General usage instructions

Install and get GitHub-like markdown with HTML preview and HTML text tabs for markdown text files.