Markdown Edit

This is a online markdown editor/viewer.
This help you to edit markdown document with the power of web technology.

Quick Start

Try on Demo page.
Or Install on your local PC. Check Guide to how to install.

Feature

Editor

Part of Editor is depend on CodeMirror.It enabeles

Display line number.
Match Brackets in the document.
Visible Tab key
Highlight syntax of markdown.
Drag and Drop file read.

For more option, see programming API of CodeMirror, and Hack Markdown Edit

Converter

To Convert markdown to html, Markdown-Edit Use Github's API as default.

The raw API is not JSON-based. It takes a Markdown document as plaintext text/plain or text/x-markdown and renders it as plain Markdown without a repository context (just like a README.md file is rendered – this is the simplest way to preview a readme online).

For more infomation, See official Guide

NOTICE : GitHub API v3 is limited 5000requests per hour.

Option: Use marked as conveter.

If you checked radio Use marked for conveter markdown-edit use marked and highlight.js instad of Github's API.
It is faster than API call and make you enable to use this app at offline.
NOTICE : marked does not support GFM Tables and Anchor.

Viewer

To display converted HTML like Github, Markdown-Edit apply github-style.css.(This css is based on github/gollum) and Font Awesome. And github.css from highlight.js will apply when it was converted by marked.

<link rel="stylesheet" href="vendor/font-awesome-2.0/css/font-awesome.css">
<link rel="stylesheet" href="css/github-style.css">
<link rel="stylesheet" href="vendor/highlight.js/styles/github.css">

If you want to see raw html what Github's API responsed, click Raw .html button on navbar.

Getting Started

Install On your local PC

Download Sources

use git

git clone http://github.com/georegeosddev/markdown-edit.git
cd markdown-edit
npm install -g bower
bower install

Or download from Here

Deploy to some web server

To avoid ajax error yous should deploy whole files to some web server.

If you are using mac,

ln -s /path/to/markdown-edit ~/Sites/markdown-edit

Then access http://localhost/~usernamehere/markdown-edit

If you have installed python,this way is very easy.

cd /path/to/markdown-edit
python -m SimpleHTTPServer 4567

Then access http://localhost:4567

NOTICE :Google Chrome upper v22.0 is most desirable browser.

usage

Read local file

Only text file is enable to read.

Save to local

This feature is not implemented yet.
So view file in Raw, and copy it to clipboard,then past it to your file by your self.

Auto Reload

If you checked Auto Reload.
Document will convert into html per 5second if it was changed.

shortcut keys

If you checked Enable Shortcut Key.
These shortcut will be enable.

Exec convert
Mac : ⌘ + e Win : ctrl + e
Browse local file
Mac : ⌘ + o Win : ctrl + o
Read local file
Mac : ⌘ + r Win : ctrl + r
View Raw .md file
Mac : ⌘ + m Win : ctrl + m
View Raw .html file
Mac : ⌘ + h Win : ctrl + h
View html in other window
Mac : ⌘ + ⌥ + h Win : ctrl + alt + h

If your are using chrome,

Enter Full Screen Mode
Mac : ⌘ + ⇧ + f Win : F11

Markdown Syntax

This app is based on github-flavored-markdown
If you're not already familiar with Markdown, you should spend 15 minutes and go over the excellent Markdown Syntax Guide at Daring Fireball.

You can use markdown syntax and also pure html like this.

Sample of Table for two

ID  |Name|Rank
----|----|----
1   |Tom Preston-Werner |Awesome
2   |Albert Einstein |Nearly as awesome

become

ID	Name	Rank
1	Tom Preston-Werner	Awesome
2	Albert Einstein	Nearly as awesome

NOTICE marked does not support GFM Tables.

and

<table>
  <tr>
    <th>ID</th><th>Name</th><th>Rank</th>
  </tr>
  <tr>
    <td>1</td><td>Tom Preston-Werner</td><td>Awesome</td>
  </tr>
  <tr>
    <td>2</td><td>Albert Einstein</td><td>Nearly as awesome</td>
  </tr>
</table>

also become

ID	Name	Rank
1	Tom Preston-Werner	Awesome
2	Albert Einstein	Nearly as awesome

Special Thanks

Licence

Source code can be found on github, licenced under MIT.

Developed by Takeharu.Oshida

nishant8bits / markdown-edit Goto Github PK

markdown-edit's Introduction