sharwell / MarkdownEditor2022

A Visual Studio extension

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Markdown Editor v2 for Visual Studio

Build

Download this extension from the Visual Studio Marketplace or get the CI build.


A full featured Markdown editor with live preview and syntax highlighting. Supports GitHub flavored Markdown.

This is a complete rewrite of the original Markdown Editor with tons of fixes, tweeks, and performance improvements. A few little-used features are not being ported to this new extension, so if you rely on them you should keep using the original.

Features

  • Powered by Markdig - the best markdown parser
  • Syntax highlighting of code blocks (using Prism.js)
  • Live preview window with scroll sync and dark theme support
  • CommonMark and GitHub flavored Markdown + FrontMatter YAML
  • Drag 'n drop of images supported
  • Paste image from clipboard directly onto document
  • Outlining/folding of code blocks
  • Keyboard shortcuts
  • Brace completion with type-through
  • Validation of relative URLs
  • Lightning fast

Live Preview Window

The preview window opens up on the right side of the document when it opens.

Preview window

Preview window

Every time the markdown document is modified, the preview window will update.

The preview window is automatically scrolled to match the scroll position of the document. As the document is scrolled up and down, the preview window will follow.

Live preview can be disabled in the settings.

Syntax highlighting

All fonts can be changed in Tools -> Options -> Environment -> Fonts and Colors dialog.

Font Options

GitHub and other flavors

Advanced markdown extensions are supported to give more features to the syntax. This includes pipe tables, emoji, mathematics and a lot more.

Drag 'n drop images

Drag an image directly from Solution Explorer onto the document to insert the appropriate markdown that will render the image.

Paste images

This is really helpful for copying images from a browser or for inserting screen shots. Simply copy an image into the clipboard and paste it directly into the document. This will prompt you for a file name relative to the document and then it inserts the appropriate markdown.

It will even parse the file name and make a friendly name to use for the alt text.

Outlining

Any fenced code and HTML blocks can be collapsed, so that this:

Outlining Expanded

...can be collapsed into this:

Outlining Collapsed

Keyboard shortcuts

Ctrl+Alt+R Refresh the preview window.

Ctrl+Alt+K Inserts a new link.

Ctrl+B makes the selected text bold by wrapping it with **.

Ctrl+I makes the selected text italic by wrapping it with _.

Ctrl+Space checks and unchecks task list items.

- [x] task list item

Tab increases indentation of list items.

Shift+Tab decreases indentation of list items.

Ctrl+K,C wraps the selection with HTML comments.

Ctrl+K,U removes HTML comments surrounding the selection/caret.

Validation

Relative URLs are validated and will show a red squiggly when they can't be resolved.

Error

The errors will also be listed in the Error List.

Context menu

Right-click anywhere in the markdown document to get easy access to common tasks, such as toggling the preview window scroll sync, see Markdown references, and getting to the settings dialog.

Context menu

Settings

Control the settings for this extension under Tools -> Options -> Text Editor -> Markdown

Options

How can I help?

If you enjoy using the extension, please give it a ★★★★★ rating on the Visual Studio Marketplace.

Should you encounter bugs or if you have feature requests, head on over to the GitHub repo to open an issue if one doesn't already exist.

Pull requests are also very welcome, since I can't always get around to fixing all bugs myself. This is a personal passion project, so my time is limited.

Another way to help out is to sponser me on GitHub.

About

A Visual Studio extension

License:Apache License 2.0


Languages

Language:C# 79.2%Language:CSS 20.7%Language:HTML 0.2%