markdown-service 1.2.0

data/lib/markdown/service/public/js/lib3rd/showdown.min.js

@@ -0,0 +1,62 @@
+//
+// showdown.js -- A javascript port of Markdown.
+//
+// Copyright (c) 2007 John Fraser.
+//
+// Original Markdown Copyright (c) 2004-2005 John Gruber
+//   <http://daringfireball.net/projects/markdown/>
+//
+// Redistributable under a BSD-style open source license.
+// See license.txt for more information.
+//
+// The full source distribution is at:
+//
+//				A A L
+//				T C A
+//				T K B
+//
+//   <http://www.attacklab.net/>
+//
+//
+// Wherever possible, Showdown is a straight, line-by-line port
+// of the Perl version of Markdown.
+//
+// This is not a normal parser design; it's basically just a
+// series of string substitutions.  It's hard to read and
+// maintain this way,  but keeping Showdown close to the original
+// design makes it easier to port new features.
+//
+// More importantly, Showdown behaves like markdown.pl in most
+// edge cases.  So web applications can do client-side preview
+// in Javascript, and then build identical HTML on the server.
+//
+// This port needs the new RegExp functionality of ECMA 262,
+// 3rd Edition (i.e. Javascript 1.5).  Most modern web browsers
+// should do fine.  Even with the new regular expression features,
+// We do a lot of work to emulate Perl's regex functionality.
+// The tricky changes in this file mostly have the "attacklab:"
+// label.  Major or self-explanatory changes don't.
+//
+// Smart diff tools like Araxis Merge will be able to match up
+// this file with markdown.pl in a useful way.  A little tweaking
+// helps: in a copy of markdown.pl, replace "#" with "//" and
+// replace "$text" with "text".  Be sure to ignore whitespace
+// and line endings.
+//
+//
+// Showdown usage:
+//
+//   var text = "Markdown *rocks*.";
+//
+//   var converter = new Showdown.converter();
+//   var html = converter.makeHtml(text);
+//
+//   alert(html);
+//
+// Note: move the sample code to the bottom of this
+// file before uncommenting it.
+//
+//
+// Showdown namespace
+//
+var Showdown={extensions:{}},forEach=Showdown.forEach=function(a,b){if(typeof a.forEach=="function")a.forEach(b);else{var c,d=a.length;for(c=0;c<d;c++)b(a[c],c,a)}},stdExtName=function(a){return a.replace(/[_-]||\s/g,"").toLowerCase()};Showdown.converter=function(a){var b,c,d,e=0,f=[],g=[];if(typeof module!="undefind"&&typeof exports!="undefined"&&typeof require!="undefind"){var h=require("fs");if(h){var i=h.readdirSync((__dirname||".")+"/extensions").filter(function(a){return~a.indexOf(".js")}).map(function(a){return a.replace(/\.js$/,"")});Showdown.forEach(i,function(a){var b=stdExtName(a);Showdown.extensions[b]=require("./extensions/"+a)})}}this.makeHtml=function(a){return b={},c={},d=[],a=a.replace(/~/g,"~T"),a=a.replace(/\$/g,"~D"),a=a.replace(/\r\n/g,"\n"),a=a.replace(/\r/g,"\n"),a="\n\n"+a+"\n\n",a=M(a),a=a.replace(/^[ \t]+$/mg,""),Showdown.forEach(f,function(b){a=k(b,a)}),a=z(a),a=m(a),a=l(a),a=o(a),a=K(a),a=a.replace(/~D/g,"$$"),a=a.replace(/~T/g,"~"),Showdown.forEach(g,function(b){a=k(b,a)}),a};if(a&&a.extensions){var j=this;Showdown.forEach(a.extensions,function(a){typeof a=="string"&&(a=Showdown.extensions[stdExtName(a)]);if(typeof a!="function")throw"Extension '"+a+"' could not be loaded.  It was either not found or is not a valid extension.";Showdown.forEach(a(j),function(a){a.type?a.type==="language"||a.type==="lang"?f.push(a):(a.type==="output"||a.type==="html")&&g.push(a):g.push(a)})})}var k=function(a,b){if(a.regex){var c=new RegExp(a.regex,"g");return b.replace(c,a.replace)}if(a.filter)return a.filter(b)},l=function(a){return a+="~0",a=a.replace(/^[ ]{0,3}\[(.+)\]:[ \t]*\n?[ \t]*<?(\S+?)>?[ \t]*\n?[ \t]*(?:(\n*)["(](.+?)[")][ \t]*)?(?:\n+|(?=~0))/gm,function(a,d,e,f,g){return d=d.toLowerCase(),b[d]=G(e),f?f+g:(g&&(c[d]=g.replace(/"/g,"&quot;")),"")}),a=a.replace(/~0/,""),a},m=function(a){a=a.replace(/\n/g,"\n\n");var b="p|div|h[1-6]|blockquote|pre|table|dl|ol|ul|script|noscript|form|fieldset|iframe|math|ins|del|style|section|header|footer|nav|article|aside",c="p|div|h[1-6]|blockquote|pre|table|dl|ol|ul|script|noscript|form|fieldset|iframe|math|style|section|header|footer|nav|article|aside";return a=a.replace(/^(<(p|div|h[1-6]|blockquote|pre|table|dl|ol|ul|script|noscript|form|fieldset|iframe|math|ins|del)\b[^\r]*?\n<\/\2>[ \t]*(?=\n+))/gm,n),a=a.replace(/^(<(p|div|h[1-6]|blockquote|pre|table|dl|ol|ul|script|noscript|form|fieldset|iframe|math|style|section|header|footer|nav|article|aside)\b[^\r]*?<\/\2>[ \t]*(?=\n+)\n)/gm,n),a=a.replace(/(\n[ ]{0,3}(<(hr)\b([^<>])*?\/?>)[ \t]*(?=\n{2,}))/g,n),a=a.replace(/(\n\n[ ]{0,3}<!(--[^\r]*?--\s*)+>[ \t]*(?=\n{2,}))/g,n),a=a.replace(/(?:\n\n)([ ]{0,3}(?:<([?%])[^\r]*?\2>)[ \t]*(?=\n{2,}))/g,n),a=a.replace(/\n\n/g,"\n"),a},n=function(a,b){var c=b;return c=c.replace(/\n\n/g,"\n"),c=c.replace(/^\n/,""),c=c.replace(/\n+$/g,""),c="\n\n~K"+(d.push(c)-1)+"K\n\n",c},o=function(a){a=v(a);var b=A("<hr />");return a=a.replace(/^[ ]{0,2}([ ]?\*[ ]?){3,}[ \t]*$/gm,b),a=a.replace(/^[ ]{0,2}([ ]?\-[ ]?){3,}[ \t]*$/gm,b),a=a.replace(/^[ ]{0,2}([ ]?\_[ ]?){3,}[ \t]*$/gm,b),a=x(a),a=y(a),a=E(a),a=m(a),a=F(a),a},p=function(a){return a=B(a),a=q(a),a=H(a),a=t(a),a=r(a),a=I(a),a=G(a),a=D(a),a=a.replace(/  +\n/g," <br />\n"),a},q=function(a){var b=/(<[a-z\/!$]("[^"]*"|'[^']*'|[^'">])*>|<!(--.*?--\s*)+>)/gi;return a=a.replace(b,function(a){var b=a.replace(/(.)<\/?code>(?=.)/g,"$1`");return b=N(b,"\\`*_"),b}),a},r=function(a){return a=a.replace(/(\[((?:\[[^\]]*\]|[^\[\]])*)\][ ]?(?:\n[ ]*)?\[(.*?)\])()()()()/g,s),a=a.replace(/(\[((?:\[[^\]]*\]|[^\[\]])*)\]\([ \t]*()<?(.*?(?:\(.*?\).*?)?)>?[ \t]*((['"])(.*?)\6[ \t]*)?\))/g,s),a=a.replace(/(\[([^\[\]]+)\])()()()()()/g,s),a},s=function(a,d,e,f,g,h,i,j){j==undefined&&(j="");var k=d,l=e,m=f.toLowerCase(),n=g,o=j;if(n==""){m==""&&(m=l.toLowerCase().replace(/ ?\n/g," ")),n="#"+m;if(b[m]!=undefined)n=b[m],c[m]!=undefined&&(o=c[m]);else{if(!(k.search(/\(\s*\)$/m)>-1))return k;n=""}}n=N(n,"*_");var p='<a href="'+n+'"';return o!=""&&(o=o.replace(/"/g,"&quot;"),o=N(o,"*_"),p+=' title="'+o+'"'),p+=">"+l+"</a>",p},t=function(a){return a=a.replace(/(!\[(.*?)\][ ]?(?:\n[ ]*)?\[(.*?)\])()()()()/g,u),a=a.replace(/(!\[(.*?)\]\s?\([ \t]*()<?(\S+?)>?[ \t]*((['"])(.*?)\6[ \t]*)?\))/g,u),a},u=function(a,d,e,f,g,h,i,j){var k=d,l=e,m=f.toLowerCase(),n=g,o=j;o||(o="");if(n==""){m==""&&(m=l.toLowerCase().replace(/ ?\n/g," ")),n="#"+m;if(b[m]==undefined)return k;n=b[m],c[m]!=undefined&&(o=c[m])}l=l.replace(/"/g,"&quot;"),n=N(n,"*_");var p='<img src="'+n+'" alt="'+l+'"';return o=o.replace(/"/g,"&quot;"),o=N(o,"*_"),p+=' title="'+o+'"',p+=" />",p},v=function(a){function b(a){return a.replace(/[^\w]/g,"").toLowerCase()}return a=a.replace(/^(.+)[ \t]*\n=+[ \t]*\n+/gm,function(a,c){return A('<h1 id="'+b(c)+'">'+p(c)+"</h1>")}),a=a.replace(/^(.+)[ \t]*\n-+[ \t]*\n+/gm,function(a,c){return A('<h2 id="'+b(c)+'">'+p(c)+"</h2>")}),a=a.replace(/^(\#{1,6})[ \t]*(.+?)[ \t]*\#*\n+/gm,function(a,c,d){var e=c.length;return A("<h"+e+' id="'+b(d)+'">'+p(d)+"</h"+e+">")}),a},w,x=function(a){a+="~0";var b=/^(([ ]{0,3}([*+-]|\d+[.])[ \t]+)[^\r]+?(~0|\n{2,}(?=\S)(?![ \t]*(?:[*+-]|\d+[.])[ \t]+)))/gm;return e?a=a.replace(b,function(a,b,c){var d=b,e=c.search(/[*+-]/g)>-1?"ul":"ol";d=d.replace(/\n{2,}/g,"\n\n\n");var f=w(d);return f=f.replace(/\s+$/,""),f="<"+e+">"+f+"</"+e+">\n",f}):(b=/(\n\n|^\n?)(([ ]{0,3}([*+-]|\d+[.])[ \t]+)[^\r]+?(~0|\n{2,}(?=\S)(?![ \t]*(?:[*+-]|\d+[.])[ \t]+)))/g,a=a.replace(b,function(a,b,c,d){var e=b,f=c,g=d.search(/[*+-]/g)>-1?"ul":"ol",f=f.replace(/\n{2,}/g,"\n\n\n"),h=w(f);return h=e+"<"+g+">\n"+h+"</"+g+">\n",h})),a=a.replace(/~0/,""),a};w=function(a){return e++,a=a.replace(/\n{2,}$/,"\n"),a+="~0",a=a.replace(/(\n)?(^[ \t]*)([*+-]|\d+[.])[ \t]+([^\r]+?(\n{1,2}))(?=\n*(~0|\2([*+-]|\d+[.])[ \t]+))/gm,function(a,b,c,d,e){var f=e,g=b,h=c;return g||f.search(/\n{2,}/)>-1?f=o(L(f)):(f=x(L(f)),f=f.replace(/\n$/,""),f=p(f)),"<li>"+f+"</li>\n"}),a=a.replace(/~0/g,""),e--,a};var y=function(a){return a+="~0",a=a.replace(/(?:\n\n|^)((?:(?:[ ]{4}|\t).*\n+)+)(\n*[ ]{0,3}[^ \t\n]|(?=~0))/g,function(a,b,c){var d=b,e=c;return d=C(L(d)),d=M(d),d=d.replace(/^\n+/g,""),d=d.replace(/\n+$/g,""),d="<pre><code>"+d+"\n</code></pre>",A(d)+e}),a=a.replace(/~0/,""),a},z=function(a){return a+="~0",a=a.replace(/(?:^|\n)```(.*)\n([\s\S]*?)\n```/g,function(a,b,c){var d=b,e=c;return e=C(e),e=M(e),e=e.replace(/^\n+/g,""),e=e.replace(/\n+$/g,""),e="<pre><code"+(d?' class="'+d+'"':"")+">"+e+"\n</code></pre>",A(e)}),a=a.replace(/~0/,""),a},A=function(a){return a=a.replace(/(^\n+|\n+$)/g,""),"\n\n~K"+(d.push(a)-1)+"K\n\n"},B=function(a){return a=a.replace(/(^|[^\\])(`+)([^\r]*?[^`])\2(?!`)/gm,function(a,b,c,d,e){var f=d;return f=f.replace(/^([ \t]*)/g,""),f=f.replace(/[ \t]*$/g,""),f=C(f),b+"<code>"+f+"</code>"}),a},C=function(a){return a=a.replace(/&/g,"&amp;"),a=a.replace(/</g,"&lt;"),a=a.replace(/>/g,"&gt;"),a=N(a,"*_{}[]\\",!1),a},D=function(a){return a=a.replace(/(\*\*|__)(?=\S)([^\r]*?\S[*_]*)\1/g,"<strong>$2</strong>"),a=a.replace(/(\*|_)(?=\S)([^\r]*?\S)\1/g,"<em>$2</em>"),a},E=function(a){return a=a.replace(/((^[ \t]*>[ \t]?.+\n(.+\n)*\n*)+)/gm,function(a,b){var c=b;return c=c.replace(/^[ \t]*>[ \t]?/gm,"~0"),c=c.replace(/~0/g,""),c=c.replace(/^[ \t]+$/gm,""),c=o(c),c=c.replace(/(^|\n)/g,"$1  "),c=c.replace(/(\s*<pre>[^\r]+?<\/pre>)/gm,function(a,b){var c=b;return c=c.replace(/^  /mg,"~0"),c=c.replace(/~0/g,""),c}),A("<blockquote>\n"+c+"\n</blockquote>")}),a},F=function(a){a=a.replace(/^\n+/g,""),a=a.replace(/\n+$/g,"");var b=a.split(/\n{2,}/g),c=[],e=b.length;for(var f=0;f<e;f++){var g=b[f];g.search(/~K(\d+)K/g)>=0?c.push(g):g.search(/\S/)>=0&&(g=p(g),g=g.replace(/^([ \t]*)/g,"<p>"),g+="</p>",c.push(g))}e=c.length;for(var f=0;f<e;f++)while(c[f].search(/~K(\d+)K/)>=0){var h=d[RegExp.$1];h=h.replace(/\$/g,"$$$$"),c[f]=c[f].replace(/~K\d+K/,h)}return c.join("\n\n")},G=function(a){return a=a.replace(/&(?!#?[xX]?(?:[0-9a-fA-F]+|\w+);)/g,"&amp;"),a=a.replace(/<(?![a-z\/?\$!])/gi,"&lt;"),a},H=function(a){return a=a.replace(/\\(\\)/g,O),a=a.replace(/\\([`*_{}\[\]()>#+-.!])/g,O),a},I=function(a){return a=a.replace(/<((https?|ftp|dict):[^'">\s]+)>/gi,'<a href="$1">$1</a>'),a=a.replace(/<(?:mailto:)?([-.\w]+\@[-a-z0-9]+(\.[-a-z0-9]+)*\.[a-z]+)>/gi,function(a,b){return J(K(b))}),a},J=function(a){var b=[function(a){return"&#"+a.charCodeAt(0)+";"},function(a){return"&#x"+a.charCodeAt(0).toString(16)+";"},function(a){return a}];return a="mailto:"+a,a=a.replace(/./g,function(a){if(a=="@")a=b[Math.floor(Math.random()*2)](a);else if(a!=":"){var c=Math.random();a=c>.9?b[2](a):c>.45?b[1](a):b[0](a)}return a}),a='<a href="'+a+'">'+a+"</a>",a=a.replace(/">.+:/g,'">'),a},K=function(a){return a=a.replace(/~E(\d+)E/g,function(a,b){var c=parseInt(b);return String.fromCharCode(c)}),a},L=function(a){return a=a.replace(/^(\t|[ ]{1,4})/gm,"~0"),a=a.replace(/~0/g,""),a},M=function(a){return a=a.replace(/\t(?=\t)/g,"    "),a=a.replace(/\t/g,"~A~B"),a=a.replace(/~B(.+?)~A/g,function(a,b,c){var d=b,e=4-d.length%4;for(var f=0;f<e;f++)d+=" ";return d}),a=a.replace(/~A/g,"    "),a=a.replace(/~B/g,""),a},N=function(a,b,c){var d="(["+b.replace(/([\[\]\\])/g,"\\$1")+"])";c&&(d="\\\\"+d);var e=new RegExp(d,"g");return a=a.replace(e,O),a},O=function(a,b){var c=b.charCodeAt(0);return"~E"+c+"E"}},typeof module!="undefined"&&(module.exports=Showdown),typeof define=="function"&&define.amd&&define("showdown",function(){return Showdown});

data/lib/markdown/service/public/js/markdown.api.js

@@ -0,0 +1,99 @@
+
+
+var markdown_apis_new = function() {
+
+  function _get_dingus( api_url, api_params, handle_html )
+  {
+    var api_params_str = $.param( api_params );
+    api_params_str += '&callback=?'  // NB: add callback for jquery jsonp; NB: need to append as string to avoid encoding of =?
+
+    $.getJSON( api_url, api_params_str, function( data ) {
+      handle_html( data.html );    // NB: assumes response { 'html': 'markup here' }
+    });
+  }
+
+  function _get_dingus_via_proxy( api_url, api_params, handle_html )
+  {
+    api_params.url = api_url;   // add url to params
+    var api_proxy_url = 'http://note.herokuapp.com/proxy'
+
+    _get_dingus( api_proxy_url, api_params, handle_html );
+  }
+
+  function _ruby_w_lib( text, lib, handle_html )
+  {
+    var api_params = {
+      text: text,
+      lib:  lib
+    }
+    var api_url = 'http://note.herokuapp.com/markdown/dingus';
+ 
+    _get_dingus( api_url, api_params, handle_html );
+  }
+
+
+  function ruby( text, handle_html )
+  {
+    var api_params = {
+      text: text
+    }
+    var api_url = 'http://note.herokuapp.com/markdown/dingus';
+ 
+    _get_dingus( api_url, api_params, handle_html );
+  }
+
+  function pandoc( text, handle_html )
+  {
+    // NB: note jsonp enabled - no cross domain request possible; use proxy server or similar
+    //   todo: find other service
+    var api_params = {
+      text: text
+    }
+    var api_url = 'http://johnmacfarlane.net/cgi-bin/pandoc-dingus'
+
+    _get_dingus_via_proxy( api_url, api_params, handle_html );
+  }
+
+
+  function kramdown( text, handle_html )
+  {
+     _ruby_w_lib( text, 'kramdown', handle_html );
+  }
+
+  function maruku( text, handle_html )
+  {
+     _ruby_w_lib( text, 'maruku', handle_html );
+  }
+
+  function redcarpet( text, handle_html )
+  {
+     _ruby_w_lib( text, 'redcarpet', handle_html );
+  }
+
+  function bluecloth( text, handle_html )
+  {
+     _ruby_w_lib( text, 'bluecloth', handle_html );
+  }
+
+  return {
+    ruby:           ruby,
+    ruby_kramdown:  kramdown,
+    ruby_maruku:    maruku,
+    ruby_redcarpet: redcarpet,
+    ruby_bluecloth: bluecloth,
+    pandoc:         pandoc
+  }
+} // fn makrdown_apis_new
+
+
+
+var markdown_apis = markdown_apis_new();
+
+////////////////
+// use like
+//
+//   markdown_apis.ruby( text, success );
+//   markdown_apis.ruby_kramdown( text, success );
+//   mardkown_apis.pandoc( text, success );
+//   etc.
+

data/lib/markdown/service/public/js/markdown.lib.js

@@ -0,0 +1,82 @@
+
+var markdown_libs_new = function() {
+
+// Showdown usage:
+//
+//   var text = "Markdown *rocks*.";
+//
+//   var converter = new Showdown.converter();
+//   var html = converter.makeHtml(text);
+//
+//   alert(html);
+
+  var showdownConverter;
+
+
+// pagedown Usage:
+//
+//   var text = "Markdown *rocks*.";
+//
+//   var converter = new Markdown.Converter();
+//   var html = converter.makeHtml(text);
+//
+//   alert(html);
+//
+
+   var pagedownConverter;
+  
+  function showdown( text, handle_html )
+  {
+    // todo: get version from code possible? how?
+
+    var html = showdownConverter.makeHtml( text );
+
+    var banner_begin = "<!-- === begin markdown block ===\n" +
+          "\n" +
+          "   generated by Showdown on " + navigator.userAgent + "\n" +
+          "     on " + new Date().toString() + "\n" +  
+          "-->\n\n"
+
+    var banner_end = "\n\n<!-- === end markdown block === -->";
+
+    handle_html( banner_begin + html + banner_end );
+  }
+
+  function pagedown( text, handle_html )
+  {
+    var html = pagedownConverter.makeHtml( text );
+
+    var banner_begin = "<!-- === begin markdown block ===\n" +
+          "\n" +
+          "   generated by pagedown on " + navigator.userAgent + "\n" +
+          "     on " + new Date().toString() + "\n" +  
+          "-->\n\n"
+
+    var banner_end = "\n\n<!-- === end markdown block === -->";
+
+    handle_html( banner_begin + html + banner_end );
+  }
+
+
+  function _init()
+  {
+    showdownConverter = new Showdown.converter();
+    pagedownConverter = new Markdown.Converter();
+  }
+
+  _init();
+
+  return {
+    showdown:   showdown,
+    pagedown:   pagedown
+  }
+} // fn makrdown_libs_new
+
+
+var markdown_libs = markdown_libs_new();
+
+////////////////
+// use like
+//
+//   markdown_libs.showdown( text, success );
+//   etc.

data/lib/markdown/service/public/js/markdown.note.js

@@ -0,0 +1,173 @@
+
+
+var markdown_note_new = function( opts ) {
+
+    // use module pattern (see JavaScript - The Good Parts)
+
+    var engines = [
+      { name:    'Standard (Offline)', online: false, markdown: markdown_libs.showdown },
+      { name:    'Standard (Online)',  online: true,  markdown: markdown_apis.ruby  },
+      { name:    'JavaScript - Showdown (Offline)', online: false, markdown: markdown_libs.showdown },
+      { name:    'JavaScript - pagedown (Offline)', online: false, markdown: markdown_libs.pagedown },
+      { name:    'Ruby - kramdown (Online)',  online: true, markdown: markdown_apis.ruby_kramdown },
+      { name:    'Ruby - Redcarpet (Online)', online: true, markdown: markdown_apis.ruby_redcarpet },
+      { name:    'Ruby - Maruku (Online)',    online: true, markdown: markdown_apis.ruby_maruku },
+      { name:    'Ruby - BlueCloth (Online)', online: true, markdown: markdown_apis.ruby_bluecloth }
+    ];
+
+    var welcome = {
+        markdown: "Welcome to Markdown. We hope you **really** enjoy using this."+
+      "\n\n"+
+      "Just type some [markdown](http://daringfireball.net/projects/markdown) on the left and see it on the right. *Simple as that.*",
+        html:     "<p>Welcome to Markdown</a>. We hope you <strong>really</strong> enjoy using this.</p>" +
+                  "<p>Just type some <a href='http://daringfireball.net/projects/markdown'>markdown</a> on the left and see it on the right. <em>Simple as that.</em></p>"
+      }
+
+
+    var settings;  // NB: defaults + opts merged => settings
+    
+    var defaults = {
+     output:        '#output',
+     output_source: '#output-source',
+     output_toggle: {
+       id: '#output-toggle',
+       label_show: '[ Show HTML ]',
+       label_hide: '[ Hide HTML ]' },
+     output_update:  '#output-update',    // a/link for update action
+     output_loading: '#output-loading',   // div for loading gif anim
+
+     input:         '#note',            // textarea for markdown source
+     input_lib:     '#note-lib',        // select inputbox for markdown libs/engines
+
+     input_toggle: {
+       id: '#input-toggle',
+       label_black: '[ Use Black Color Theme]',
+       label_white: '[ Use White Color Theme]'
+     },
+
+     engines:  engines,
+     
+     welcome:  welcome
+    }
+
+
+    function _debug( msg )
+    {
+      if(window.console && window.console.log )
+        window.console.log( "[debug] " + msg );
+    }
+
+    var $output,
+        $output_source,
+        $output_toggle,
+        $output_update,
+        $output_loading,
+        $input,
+        $input_lib,
+        $input_toggle;
+
+
+    var show_html = false;
+    var use_white_color_theme = false;
+
+    function toggle_output()
+    {
+      show_html = !show_html;
+    
+      if( show_html ) {
+        $output_toggle.html( settings.output_toggle.label_hide );
+        $output.hide();
+        $output_source.show();
+      }
+      else {
+        $output_toggle.html( settings.output_toggle.label_show );
+        $output.show();
+        $output_source.hide();
+      }
+    }
+
+
+    function _toggle_color_theme()
+    {
+   /**
+     *  todo: move to addon?? out of "core"
+     */
+ 
+      use_white_color_theme = !use_white_color_theme;
+      if( use_white_color_theme ) {
+        $input.removeClass( 'black' );
+        $input_toggle.html( settings.input_toggle.label_black );
+      }
+      else {
+        $input.addClass( 'black' );
+        $input_toggle.html( settings.input_toggle.label_white );
+      }
+    }
+
+
+    function update_output()
+    {
+      var text = $input.val();  // get markdown text
+      var engine_index = parseInt( $input_lib.val(), 10);
+
+      var engine = settings.engines[engine_index];
+
+      if( engine.online === true )
+         $output_loading.show();
+
+      engine.markdown( text, function( html ) {
+         $output.html( html );
+         $output_source.html( html );
+         $output_loading.hide();
+      });
+    }
+
+
+   function _init( opts )
+   {
+     settings = $.extend( {}, defaults, opts );
+
+
+     $output         = $( settings.output );
+     $output_source  = $( settings.output_source );
+     $output_update  = $( settings.output_update );
+     $output_toggle  = $( settings.output_toggle.id );
+     $output_loading = $( settings.output_loading );
+
+     $input         = $( settings.input );
+     $input_lib     = $( settings.input_lib );
+
+     $input_toggle  = $( settings.input_toggle.id );
+
+     $input.val( settings.welcome.markdown );
+
+     $output.html( settings.welcome.html );
+     $output_source.html( settings.welcome.html );
+
+
+     $output_update.click( function() { update_output(); } );
+     $output_toggle.click( function() { toggle_output(); } );
+
+     $input_toggle.click( function() { _toggle_color_theme(); } );
+     
+     // add markdown engine/lib options
+     var markdown_opts = '';
+     $.each( engines, function(index, engine) {
+        markdown_opts += '<option value="' + index + '"';
+        if( index == 0 ) {
+          markdown_opts += 'selected="selected"'
+        }
+        markdown_opts += '>' + engine.name + '</option>';
+        
+        _debug( 'add markdown engine [' + index + ']: ' + engine.name );
+     });
+     $input_lib.html( markdown_opts );
+   }
+
+   _init( opts );
+   
+    return {
+      update: update_output,
+      toggle: toggle_output
+    }
+} // fn markdown_note_new

data/lib/markdown/service/public/note.html

@@ -0,0 +1,72 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset='UTF-8'>
+  <title>Markdown Note</title>
+
+  <link href='css/markdown/note.css' rel='stylesheet'>
+  <link href='css/markdown/themes/basic.css' rel='stylesheet'>
+
+  <script src='js/lib3rd/jquery-2.0.1.min.js'></script>
+  <script src='js/lib3rd/showdown.min.js'></script>
+  <script src='js/lib3rd/pagedown.js'></script>
+
+  <script src='js/markdown.api.js'></script>
+  <script src='js/markdown.lib.js'></script>
+
+  <script src='js/markdown.note.js'></script>
+  <script>
+    $(document).ready( function () {
+       markdown_note_new();
+    });
+  </script>
+</head>
+<body>
+
+
+<table width='100%'>
+ <colgroup>
+   <col width='50%'>
+   <col width='50%'>
+ </colgroup>
+ <tr>
+   <td>
+     <!-- first column -->
+
+      <div id='input'>
+        <textarea id='note' class='black'></textarea>
+      </div>
+
+   </td>
+   <td style='vertical-align: top;'>
+     <!-- second column -->
+
+      <div id='output' class='markdown'></div>
+      <textarea id='output-source' readonly='readonly'></textarea>
+
+   </td>
+ </tr>
+ <tr>
+  <td>
+    <!-- first column -->
+
+    <span>
+      Use <select id='note-lib'></select>
+    </span>
+
+    <a id='output-update' href='#'>[ Update ]</a>
+    <a id='input-toggle' href='#'>[ Use White Color Theme ]</a>
+
+     <!-- nb: div will break/start new line -->
+     <div id='output-loading'></div>
+  </td>
+  <td style='vertical-align: top;'>
+     <!-- second column -->
+     <a id='output-toggle' href='#'>[ Show HTML ]</a>
+     
+  </td>
+ </tr>
+</table>
+
+</body>
+</html>