Enhanced Features
- Split Layout Control
- Live Templates
- Surround Live Templates
- Actions and Keymap
- As You Type Enhancements
| Button | Action | Notes |
|---|---|---|
 |
Show editor and preview | |
 |
Show preview only | |
 |
Show editor only | |
 |
Show HTML preview | |
 |
Show HTML text used for browser | |
 |
Show plain HTML as generated by parser | Plain HTML as converted from markdown by the parser |
 |
Print HTML preview | only JavaFX WebView preview broswer supported |
Actions available but not in the toolbar. Can be mapped to shortcuts.
| Non Toolbar Actions | Action | Notes |
|---|---|---|
 |
Cycle split layout | |
 |
Toggle Editor Layout | toggles preview on/off |
 |
Cycle preview content | cycle through preview, modified and unmodified HTML preview types |
| Button | Action | Notes |
|---|---|---|
 |
Toggle wrap on typing | |
 |
Toggle bold text | |
 |
Toggle italic text | |
 |
Toggle strike through text | |
 |
Toggle underline/inserted text | Underline parser extension must be enabled |
 |
Toggle superscript text | Superscript parser extension must be enabled |
 |
Toggle subscript text | Subscript parser extension must be enabled |
 |
Toggle code span | |
 |
Insert explicit link | |
 |
Decrease quote level | |
 |
Increase quote level | |
 |
Increase header level | |
 |
Decrease header level | |
 |
Toggle header type | |
 |
Un-Indent list item | |
 |
Indent list item | |
 |
Single space list | Single space all items in a list. Caret placed on one of the list items |
 |
Double space list | Double space all items in a list. Caret placed on one of the list items |
 |
Bullet list | Convert caret item or items in selection to bullet list items. If all are already bullet items then convert to plain text |
 |
Numbered list | Convert caret item or items in selection to numbered list items. If all are already numbered items then convert to plain text |
 |
Task list | Convert caret item or items in selection to task list items. If all are already task items then convert to plain text |
 |
Toggle task item done | Toggle done status of caret item or items in selection |
 |
Toggle auto-format table | Toggle format table as you type mode. |
 |
Insert table | Inserts a 1x3 table that you can edit to add more rows and columns. |
 |
Insert table row | Insert a row below the caret. Also done by ENTER |
 |
Insert table column | Insert a column left of the column with caret. |
 |
Delete table row | Delete the row with the caret. Also done by ENTER |
 |
Delete table column | Delete the column with the column with caret. |
 |
Reformat current element | Wrap paragraph, format table or update table of contents element |
 |
Reformat current document | Apply code style to current document |
 |
Copy JIRA formatted text | Copy current selection or document as JIRA formatted text |
 |
Copy YouTrack formatted text | Copy current selection or document as YouTrack formatted text |
 |
Copy HTML formatted text | Copy current selection or document as HTML formatted text that can be pasted into applications that support the format. i.e. e-mail, word processing, etc. |
 |
Export Rendered Html | Export rendered HTML as per rendering profile |
 |
Export Markdown as PDF | Export Markdown as PDF rendered HTML formatted text |
| Element | Abbreviation | Expansion |
|---|---|---|
| Abbreviation | .abbreviation |
*[]: |
| Fenced Code | .codefence |
``` ... ``` |
| Collapsed Markdown | .collapse |
<details><summary>...<summary>... <details>
|
| Emoji | .emoji |
:: |
| Explicit link | .link |
[]() |
| Footnote | .footnote |
[^]: |
| Footnote Ref | .rfootnote |
[^] |
| Image | .image |
![]() |
| Ref image | .rimage |
![][] |
| Ref link | .rlink |
[][] |
| Reference | .reference |
[]: |
| Table | .table |
` |
| Task | .task |
- [ ] |
| Table of Contents | .toc |
[TOC]: # |
| Wiki link | .wikilink |
[[]] |
Collapsed Markdown live template must be enabled in Live Templates > Markdown
Collapsed Markdown creates a collapsible markdown snippet that will be correctly rendered on GitHub. This Live Template comes disabled by default and must be enabled before it will be available for completions.
Since the preview is updated as changes to the markdown document is made the <details> tags
will be refreshed in the closed form after every update. To make it easier to work on a document
with <detail> tags you should enable the Details tag opener scrip in Stylesheet settings so
that these tags will be opened after every update.
| Element | Abbreviation | Expansion |
|---|---|---|
| Fenced Code | MM |
Surround selection with Markdown Fenced Code |
| Collapsed Markdown | CM |
Surround selection with Markdown Collapsible section |
| Formatter off/on comments | EM |
Surround selection with Markdown @formatter off/on comments |
The formatter off/on wrapping can be used to manually control formatting of a section or sections of a document while allowing the rest of the document formatting to be automated.
All actions defined by the Markdown Navigator plugin can be used to create custom key mapping under Keymap > Plug-ins > Markdown Navigator under Preferences (OS X)/settings (Win/UX).
This includes all toolbar button actions and view toggling actions, which lets you customize your shortcuts to your most frequently used actions.
The style toggle actions for: bold, italic, strikethrough, underline, superscript, subscript,
and inline code will toggle their corresponding style on/off for word or selection. When used
without a selection with the caret at beginning or end of word they will apply the style to the
word, delimited by spaces and with any punctuations at the end of the word ignored. Default
punctuation symbols are .,:;?! and can be customized in the main options panel for Markdown
Navigator in Languages & Frameworks > Markdown
The default behavior for the inline code toggle actions is to toggle the inline code like it was
a text style. To make this action add more back ticks around the inline code element when the
caret is at the end of it, turn off the Toggle inline code like text style in the main options
panel for Markdown Navigator in Languages & Frameworks > Markdown
There are actions to navigate to next/previous cell/start/end. The Cell navigation will stop on Cell Start and Cell End. Actions "With Selection" will extend the selection, the others don't. All will stop at start/end of table row and wrap to next/previous row if it exists.
With Wrap on typing option enabled, typing in a text block will re-format the text block when
a space is typed and the line containing the caret extends beyond the current right margin. The
limitation on when wrapping is done is intended to reduce the overhead and delay when typing.
BACKSPACE will reformat the paragraph every time.
Additionally, typing/backspacing a space or a block quote > before the first character of a
paragraph will optionally match the block quote markers and indentation on all the continuation
lines for the paragraph.
Similarly, typing between a list marker and the first character of the paragraph will optionally indent the continuation lines to line them up with the first position of the text on the first line.
With Auto-format table on typing enabled will result in the table formatting options being
applied as you edit the table. This does delay the typing but does make it easier to see the
results. When performing extensive edits to a table you can temporarily turn off this options on
the toolbar.
If Add missing columns is enabled the typing before the leftmost pipe character will insert a
column into the table before the first column. Typing after the rightmost pipe character will
add a column after the last. If the table rows have un-even column numbers then reformatting a
table via the Format element button will also add columns but will do so at a location based
on the column that contains the caret. This way you can control where the missing columns are
inserted. For full control you should use the Insert table column button.
Delete empty row/col on backspace will automatically delete a row or column when BACKSPACE is performed in an empty row/column. Row deletion has priority over column deletion.
Insert on ENTER will add an empty table row below the row that contains the caret.
When pasting markdown text copied from a markdown file link and footnote references will automatically paste the references at the end of the file so that these references resolve in the destination file.
Links and link references will also be adjusted to reflect the change in the source reference file. The destination link address format will be changed to absolute URL format if the destination file link cannot be resolved in the original link format.
Copy Markdown to HTML formatted text will copy the current selection or document if there is
no selection, to the clipboard as HTML formatted mime content which can be pasted into any
application that supports HTML formatted content such as e-mail or word processing application.
This action is available in the toolbar and in the main menu under Tools > Markdown Navigator > Copy Markdown
Rendering profile for this action can be customized by creating a Profile named
COPY_HTML_MIME, Preview settings are not used. Parser, Stylesheet and HTML Generation
will allow customization of what HTML formatted text is copied.
Note that the HTML stylesheet is not a standard CSS format file since the HTML element styles
are set via the style attribute for each element. The style sheet is a simplified format with
each line containing the selector and all the styles for the element. When rendering markdown to
HTML, this stylesheet is parsed and the styles contained for each selector are applied to the
matching elements.
Use html_mime_default.css as a starting template. All style settings must be contained in a
single matching one line entry since they are set in each element and there is no stylesheet.
The "css" text is parsed with a simple parser, one line comments stripped out and each line's
style attributed to element selector, with style to be added to the element's style attribute.
The "parent" selector is based on Markdown AST hierarchy and not actual HTML, so any HTML tags
surrounding Markdown elements will have no effect. The classes are hardcoded into the attribute
provider such as: tr.odd, tr.even and li.loose based on Markdown AST.
Table of contents for your document can be generated for standard markdown parsers that do not support a table of contents element.
The lines after the [TOC]: # tag are updated to reflect the content of the document when you
reformat document or reformat element
. More details in Adding a Table of Contents
For a toc element [TOC levels=3]: #### "Table of Contents" and these headers in the document:
# Heading **some bold** 1
## Heading 1.1 _some italic_
### Heading 1.1.1
### Heading 1.1.2 **_some bold italic_**
# Heading 2
### Heading 2.0.1After an update the table of contents element will look like the following:
Markdown version:
[TOC levels=1-3]: #### "Contents"
#### Contents
- [Heading **some bold** 1](#heading-some-bold-1)
- [Heading 1.1 _some italic_](#heading-11-some-italic)
- [Heading 1.1.1](#heading-111)
- [Heading 1.1.2 **_some bold italic_**](#heading-112--some-bold-italic)
- [Heading 2](#heading-2)
- [Heading 2.0.1](#heading-201)HTML version:
[TOC levels=1-3]: #### "Contents"
<div><h4>Contents</h4>
<ul>
<li><a href="#heading-some-bold-1">Heading <strong>some bold</strong> 1</a>
<ul>
<li><a href="#heading-11-some-italic">Heading 1.1 <em>some italic</em></a>
<ul>
<li><a href="#heading-111">Heading 1.1.1</a></li>
<li><a href="#heading-112--some-bold-italic">Heading 1.1.2 <strong><em>some bold italic</em></strong></a>
</ul></li>
</ul></li>
<li><a href="#heading-2">Heading 2</a>
<ul>
<li><a href="#heading-201">Heading 2.0.1</a></li>
</ul></li>
</ul>
</div>