ScholarlyMarkdown: A Markdown Flavor for Science and Math Scholarship

ScholarlyMarkdown is a syntax/standard/best-practice of scholarly and academic communication that is web-first, semantic XML-second, and LaTeX/Word a close third. Its main goal is to produce a semantically model of a scholarly article based on Markdown input, and translate it to a variety of formats that is suitable for both online scholarly communication, archiving, and publication.
ScholarlyMarkdown introduces some new syntax for scholarly and academic features. However, at the same time it aims to be composed of 100% valid Github-Flavored Markdown and PHP Markdown Extra syntax and almost 90% backwards compatibility with existing renderers of those syntaxes, while being 100% compatible with Pandoc-markdown. It contains no completely new syntax over the previous standards, and instead provides its power from conventions.
Furthermore, ScholarlyMarkdown borrows a unique templating system/language from Pandoc with variables and metadata that may be set using YAML blocks inside the document. This allows flexibility to configure the output formatting to your heart’s content without polluting the source text with presentation-specific code.

via ScholarlyMarkdown.

This looks like a worthwhile and promising project. It is important to note that the “scholarly” part is really a reference to including math and figures in Markdown and it requires a modified fork of Pandoc for rendering into HTML.

If you want to try Markdown with legal stuff see https://github.com/compleatang/legal-markdown and http://legalmarkdown.com/.

If you want to author legal scholarship, or any other scholarship,  in a plain text format and skip Word or WordPerfect altogether, I’d recommend using AsciiDoc, it was built for authoring complex documents like scholarly articles. For an example of legal scholarship in AsciiDoc see my article The Classical Roots of Binary Economics at http://elide.us/96.

O’Reilly Takes The Plunge Into Collaborative Authoring With Open Feedback

Over the last few years, traditional publishing has been moving closer to the web and learning a lot of lessons from blogs and wikis, in particular. Today we’re happy to announce another small step in that direction: our first manuscript (Programming Scala) is now available for public reading and feedback as part of our Open Feedback Publishing System. The idea is simple: improve in-progress books by engaging the community in a collaborative dialog with the authors out in the open. To do this, we followed the model of the Django Book, Real World Haskell, and Mercurial: The Definitive Guide (among others) and built a system to regularly publish the whole manuscript online as HTML with a comment box under every paragraph, sidebar, figure, and table.After the impressive success of the Rough Cuts program from Safari Books Online, which we’ve long supported, and Real World Haskell, which used a similar system, we we’re extremely eager to try the idea out with more titles.

Collaborative Publishing Based on Community Feedback – O’Reilly Labs

Seems like a step in the right direction.  The ability to comment on a work at the paragraph level is a great idea.  I wonder if the OPFS engine for turning a book or manuscript into a commentable website will ne made available for others to use?

Blogged with the Flock Browser