HTML to Markdown JavaScript converter

Question

Searching a JavaScript library that should convert HTML code to Markdown format.

It should have the following features:

• convert basic HTML tags to Markdown (h1...6, pre, code etc)
• keep the HTML code if it hasn't a correspondent in Markdown (e.g. iframe)
• work on server side (NodeJS)
• work on client side (browser)

First three points are important for me, but any recs/suggestions are welcome.

---

Examples

HTML                                    | Converted
----------------------------------------+---------------------------------
<h1>Hello World</h1>                    | # Hello World
----------------------------------------+---------------------------------
<h1 class="foo">Hello World</h1>        | <h1 class="foo">Hello World</h1>
----------------------------------------+---------------------------------
<p>Lorem ipsum</p>                      | Lorem ipsum
----------------------------------------+---------------------------------
<p data-something="foo">Lorem ipsum</p> | <p data-something="foo">Lorem ipsum</p>
----------------------------------------+---------------------------------
<img src="something">                   | ![](something)
----------------------------------------+---------------------------------
<a href="...">foo</a>                   | [foo](...)
----------------------------------------+---------------------------------
<a disabled="" href="...">foo</a>       | <a disabled="" href="...">foo</a>

Answer 1

Usually I really like Pandoc for all my text format conversion needs. However it is Haskell based - though it does have easy install/executable options for most OSes. Of course it can't be run via JavaScript very well - Sure you can work something up with Node.js and streams; but why bother when it has already been done: Jandoc.

Jandoc does everything Pandoc does but with (Node.js) JavaScript wrappers.

Installation is slightly complicated;

1. Install Node.js
2. Install the Haskell Platform.
3. Run cmd prompt and execute cabal update (that doesn't update cabal just the package source listing, to update cabal (if desired/needed) run cabal install cabal-install)
4. cmd prompt: cabal install pandoc (It'll take a while)
5. cmd prompt: npm install jandoc -g

API information is in the Jandoc Readme.

To go over your requirements:

• convert basic HTML tags to Markdown (h1...6, pre, code etc): Yes
• keep the HTML code if it hasn't a correspondent in Markdown (e.g. iframe): Yes - if using the -R/--parse-raw option. So for Jandoc via the JavaScript API you'd just include a parseRaw: True argument in your options list.
• work on server side (Node.JS): Yes
• work on client side (browser): NO. Not easily portable to browser usage either.