up

MORE.md

@@ -6,3 +6,15 @@
 [SPIP](http://spip.net) is an open source CMS
 
 - [spip2markdown](https://github.com/nhoizey/spip2markdown) - convert SPIP syntax to Markdown
+
+
+### Command Line Tool Examples
+
+```
+$ pandoc file.html -o file.md
+```
+
+
+```
+$ kramdown --input html --output kramdown file.html > file.md
+```

README.md

@@ -61,16 +61,32 @@ Documentation
 - [Code :octocat:](https://github.com/piwi/markdown-extended) - converter script in PHP
 
 
+## Manuscripts
+
+_Free book format for Markdown_
+
+**Manuscripts**
+(web: [`manuscripts.github.io`](http://manuscripts.github.io),
+ github: [`manuscripts`](https://github.com/manuscripts)) -
+adds book.yml for book (meta) info e.g. title, author, publisher, year etc.
+and contents.yml for table of contents and file strucutre
+
+- Manuscripts Book Starter Kit (github: [`manuscripts/book-starter`](https://github.com/manuscripts/book-starter))
+
+
 
 ## CommonMark
 
 _A strongly specified, highly compatible implementation of Markdown_
 
-- [CommonMark @ commonmark.org](http://commonmark.org)
-    - [Spec](http://spec.commonmark.org)
-    - [Dingus](http://spec.commonmark.org/dingus) - try CommonMark in your browser
-    - [Talk](http://talk.commonmark.org)
-- [Code :octocat:](https://github.com/jgm/CommonMark) - spec and reference code in JavaScript and C
+**CommonMark**
+(web: [`commonmark.org`](http://commonmark.org))
+
+- Spec (web: [`http://spec.commonmark.org`](http://spec.commonmark.org))
+- Dingus (web: [`spec.commonmark.org/dingus`](http://spec.commonmark.org/dingus)) - try CommonMark in your browser
+- Talk (web: [`talk.commonmark.org`](http://talk.commonmark.org))
+- Code (github: [`jgm/CommonMark`](https://github.com/jgm/CommonMark)) - spec and reference code in JavaScript and C
+
 
 
 ## Markdown Documentation
@@ -96,9 +112,6 @@ _A strongly specified, highly compatible implementation of Markdown_
  github: [github.com/jgm/pandoc](https://github.com/jgm/pandoc)) -
 a universal document converter (in Haskell)
 
-```
-$ pandoc file.html -o file.md
-```
 
 **kramdown**
 (web: [`kramdown.gettalong.org`](http://kramdown.gettalong.org),
@@ -106,10 +119,6 @@ $ pandoc file.html -o file.md
  gem: [`kramdown`](https://rubygems.org/gems/kramdown)) -
 markdown library & command line tool (in Ruby)
 
-```
-$ kramdown --input html --output kramdown file.html > file.md
-```
-
 
 **Markdown Extended (MDE)**
 (github: [`e-picas/markdown-extended`](https://github.com/e-picas/markdown-extended)
@@ -123,6 +132,17 @@ $ kramdown --input html --output kramdown file.html > file.md
 - [Babelmark 2]() - a tool for comparing the output of various implementations of Markdown syntax
     - [Babelmark 2 F.A.Q.](http://johnmacfarlane.net/babelmark2/faq.html) - frequently asked questions (and answers) e.g. ... ??
 
+
+### Markdown Style Guides / Best Practices
+
+to be done
+
+### Markdown Lint / Style Rule Checker
+
+- [mdlint]() to be done
+
+
+
 ### Markdown Web Components / Custom Elements
 
 - [`<x-markdown>`]() - to be done
@@ -175,9 +195,21 @@ a free web alternative to PowerPoint and Keynote in Ruby
 - [markdown-pdf :octocat:](https://github.com/alanshaw/markdown-pdf), [(npm Package)](https://www.npmjs.com/package/markdown-pdf) -  converts Markdown files to PDFs
 
 
+### Markdown Styles / Documents / Pages
+
+**The Zen of Page Designs**
+(github: [`pagedesigns`](https://github.com/pagedesigns))
+
+
 ### Markdown to Books
 
-- [Hyper Book (H9) :octocat:](https://github.com/hybook), [:gem:](https://rubygems.org/gems/hybook)
+**The Zen of Book Designs**
+(github: [`bookdesigns`](https://github.com/bookdesigns))
+
+
+
+**Hyper Book (H9)** [:octocat:](https://github.com/hybook), [:gem:](https://rubygems.org/gems/hybook)
+
 - [Templates :octocat:](https://github.com/book-templates)
 
 
@@ -188,6 +220,7 @@ to be done
 
 
 
+
 ## Convert to Markdown Tools
 
 ### Microsoft Word to Markdown
@@ -213,8 +246,6 @@ JavaScript / Node.js
 - [html2markdown :octocat:](https://github.com/alexgorbatchev/html2markdown),  [(npm Package)](https://www.npmjs.com/package/html2markdown) -  converting HTML to Markdown
  
 
-
-
 ## Book Services
 
 - [Softcover.io](https://www.softcover.io) - publish from the comfort of your command-line
@@ -225,18 +256,6 @@ JavaScript / Node.js
     - [Franklin :octocat:](https://github.com/bryanbraun/franklin) - a static-site framework, optimized for online books
 
 
-## Alternatives
-
-_More lightweight markup languages_
-
-- [Wikitext, Wikicode](http://en.wikipedia.org/wiki/Help:Wiki_markup) - wiki markup used by Wikipedia and friends
-   - [Creole](http://en.wikipedia.org/wiki/Creole_(markup))  - "Standardized" core Wikitext markup
-- [AsciiDoc](http://en.wikipedia.org/wiki/AsciiDoc)
-- [Textile](http://en.wikipedia.org/wiki/Textile_(markup_language))
-- [reStructuredText (rst, reST)](http://en.wikipedia.org/wiki/ReStructuredText)
-- [BBCode](http://en.wikipedia.org/wiki/BBCode) - bulletin board code
-
-
 ## Meta
 
 **License**