Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/yasumichi/seapig

SeaPig is converter from markdown to html with marked.js and highlight.js.
https://github.com/yasumichi/seapig

Last synced: about 1 month ago
JSON representation

SeaPig is converter from markdown to html with marked.js and highlight.js.

Awesome Lists containing this project

README

        

SeaPig
=====

![](seapig.png)SeaPig is converter from markdown to html with marked.js and highlight.js.

![](images/seapig.png)

## Usage

SeaPig has two panes. Left pane is editor. Right pane is HTML previewer.

When you input markdown, SeaPig refresh HTML preview.

You can use [GitHub Flavored Markdown](https://github.github.com/gfm/).

SeaPig has tool bar contains one drop down list and eight buttons.

![](images/seapig-toolbar.png)

You can select key bindings from drop down list. (default/emacs/vim/sublime)

Eight buttons has feature below.

- New markdown file (Open new window)
- Open markdown file to editor.
- Save markdown file from editor.
- Export HTML file from previewer.(At the same time css stylesheet is copied to same folder.)
- Export PDF file
- Hide editor
- Hide previewer
- Refresh HTML preview

### viz.js support

When You write code block as `graphviz` language and write dot language, rendering graph image at svg as below.


```graphviz
digraph g { a -> b; }
```

to

![](images/digraph.png)

### uiflow support

When You write code block as `uiflow` language and write uiflow language, rendering graph image at svg as below.


```uiflow
[top page]
user name
password
--
login
==>mypage

[mypage]
favorite list
```

to

![](images/uiflow.png)

### MathJax support (code block only)


```math
E=mc^2
```

to

![](images/mathjax.png)

More example, [test/mathjax.md](test/mathjax.md)

### mermaid support

When You write code block as `mermaid` language and write mermaid language, rendering graph image at svg as below.


```mermaid
sequenceDiagram
participant main
participant renderer
participant previewer
main->>renderer: Open file
renderer->>previewer: Refresh preview
```

to

![](images/mermaid.png)

## For developers

### How to build

```
$ git clone https://github.com/yasumichi/seapig.git
$ cd seapig
$ git submodule update -i
$ npm install
$ npm build-dep
...
```

### How to lunch

```
$ npm start
```

### How to package

```
$ npm run package:win32
```

### How to package all (on Linux)

```
$ ./build.sh
```

## ToDo

- [x] save your favorite keybindings (default/emacs/vim)
- [x] support task list item.
- [x] add viz.js support
- [x] add [uiflow](https://github.com/hirokidaichi/uiflow) support.
- [x] add mermaid support
- [x] add simultaneous scroll
- [x] add original menu
- [x] add new document
- [ ] add alternative stylesheet
- [x] control display editor and previewer
- [ ] add batch mode
- [x] introduce virtual dom framework (mithril.js)

## Special Thanks

- [Ace - The High Performance Code Editor for the Web](https://ace.c9.io/)
- [Electron - Build cross platform desktop apps with JavaScript, HTML, and CSS.](http://electron.atom.io/)
- [electron-json-storage](https://github.com/jviotti/electron-json-storage)
- [electron-localshortcut](https://github.com/parro-it/electron-localshortcut)
- [Github Markdown CSS - for Markdown Editor Preview](https://gist.github.com/andyferra/2554919)
- [highlight.js](https://highlightjs.org/)
- [marked](https://github.com/chjj/marked)
- [MathJax](https://www.mathjax.org/)
- [mermaid](https://knsv.github.io/mermaid/)
- [mithril](https://mithril.js.org/)
- [Node.js](https://nodejs.org/en/)
- [Photon](http://photonkit.com/)
- [sanitize-html](https://github.com/apostrophecms/sanitize-html)
- [viz.js](https://github.com/mdaines/viz.js)
- [uiflow](https://github.com/hirokidaichi/uiflow)(use [forked version](https://github.com/tkrkt/uiflow#fix-argument-in-compile))
- [いらすとや](http://www.irasutoya.com/)(application icon)
- [jpzukin/electron-sample-print-to-pdf](https://github.com/jpzukin/electron-sample-print-to-pdf)

# License

MIT (excludes photon, node_modules and icons)

Copyright © 2016-2019 Yasumichi Akahoshi

# Icons copyright

- seapig.icns
- seapig.ico
- seapig.png

Copyright © いらすとや. All Rights Reserved.