make academic writing less frustrating

Note: The ScholarlyMarkdown Project is currently in early alpha and should be considered extremely experimental. This website is essentially a draft copy for a much more complete site. Please bookmark this page or follow the maintainer on Twitter

Let’s keep the dream of academic writing using Markdown alive.

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.

More Info

ScholarlyMarkdown Guide

ScholarlyMarkdown FAQs

ScholarlyMarkdown HTML Schema


Scholdoc is the reference implementation of ScholarlyMarkdown. It is a fork of Pandoc and is built upon the same general parsing engine, but because it is focused exclusively on academic writing it can afford to be more nimble with breaking changes. Think of it as a prototyping tool for new ideas.

ScholarlyMarkdown Core CSS is a CSS3 stylesheet that provides the necessary baseline formatting for all HTML output of ScholarlyMarkdown (figure spacing, math element spacing, etc). Some namespacing is used to avoid overriding existing styling. You should include it in every HTML file that scholdoc generates.

You can find the latest ScholarlyMarkdown Core CSS here

ScholarlyMarkdown Heuristically Theme is a CSS3 stylesheet that, along with the Heuristica webfont, produces the look and feel of this website. It is a responsive theme designed to look good for general academic documents. Special attention have been paid to make sure that mathematical content looks good with this theme. Heuristically includes the ScholarlyMarkdown Core CSS so there is no need to link to it separately in your HTML.

You can get the latest version of the Heuristically theme here


ScholarlyMarkdown is developed and maintained by