Formalize spec for SSMD

[jayjlawrence]

As I embrace Markdown (CommonMark) for my documentation needs I am really keen on SSMD for speech requirements.

Learning from Markdown's past I think we should invest in creation of a spec for SSMD that's built off of CommonMark to avoid future issues.

Thoughts?

[jayjlawrence]

Here's a couple of references. First John Gruber's initial spec: https://daringfireball.net/projects/markdown/syntax

And now what CommonMark has refined it to:
https://spec.commonmark.org/0.28/

[machisuji]

You mean the SSMD spec should follow the general structure of the common mark spec you linked?
I guess I could try to describe the different cases in a bit more detail and make sure to avoid any ambiguities.

The general idea seems to be the same at least between CommonMark's and our SPECIFICATION.MD looking at this section in the common mark spec:

This document attempts to specify Markdown syntax unambiguously. It contains many examples with side-by-side Markdown and HTML. These are intended to double as conformance tests. An accompanying script spec_tests.py can be used to run the tests against any Markdown program: