Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/math2001/markdownlivepreview

A Sublime Text 3 plugin to preview your markdown as you type
https://github.com/math2001/markdownlivepreview

live-preview markdown python sublime-text sublime-text-3

Last synced: about 1 month ago
JSON representation

A Sublime Text 3 plugin to preview your markdown as you type

Awesome Lists containing this project

README

        

# MarkdownLivePreview

A simple plugin to preview your markdown as you type right in Sublime Text.
No dependencies!

## How to install

It's available on package control!

## Setting a keybinding

The open the preview, you can search up in the command palette
(ctrl+shift+p) `MarkdownLivePreview: Open Preview`. But if you
prefer to have a shortcut, add this to your keybindings file:

```json
{
"keys": ["alt+m"],
"command": "open_markdown_preview"
}
```

## How to contribute

If you know what feature you want to implement, or what bug you wanna fix, then
go ahead and hack! Maybe raise an issue before hand so that we can talk about
it if it's a big feature.

But if you wanna contribute just to say thanks, and don't really know what you
could be working on, then there are a bunch of `FIXME`s all over this package.
Just pick one and fix it :-)

```
$ git clone https://github.com/math2001/MarkdownLivePreview
$ cd MarkdownLivePreview
$ grep -R FIXME
```

### Hack it!

1. Fork this repo
2. Make your own branch (the name of the branch should be the feature you are
implementing eg. `improve-tables`, `fix-crash-on-multiple-preview`
3. All your code should be formated by black.
4. Send a PR!

### Known limitations

#### Numbered lists are rendered as unordered lists

```md
1. first
2. second
3. third
```

will be previewed the exact same way as

```md
- first
- second
- third
```

The issue comes from [Sublime Text's minihtml](https://www.sublimetext.com/docs/3/minihtml.html) which [doesn't support ordered lists](https://github.com/sublimehq/sublime_text/issues/1767). If you think feel like implementing a workaround, feel free to contribute, but it's not something I'm planning on doing. It isn't a critical feature, and support should come with time...