version 1.176, 2017/03/04 17:17:34 |
version 1.178, 2017/03/08 19:40:59 |
|
|
format conforming to |
format conforming to |
.Lk http://daringfireball.net/projects/markdown/syntax.text\ |
.Lk http://daringfireball.net/projects/markdown/syntax.text\ |
"John Gruber's 2004 specification" . |
"John Gruber's 2004 specification" . |
|
The output also almost conforms to the |
|
.Lk http://commonmark.org/ CommonMark |
|
specification. |
.Pp |
.Pp |
|
The character set used for the markdown output is ASCII. |
|
Non-ASCII characters are encoded as HTML entities. |
|
Since that is not possible in literal font contexts, because these |
|
are rendered as code spans and code blocks in the markdown output, |
|
non-ASCII characters are transliterated to ASCII approximations in |
|
these contexts. |
|
.Pp |
Markdown is a very weak markup language, so all semantic markup is |
Markdown is a very weak markup language, so all semantic markup is |
lost, and even part of the presentational markup may be lost. |
lost, and even part of the presentational markup may be lost. |
Do not use this as an intermediate step in converting to HTML; |
Do not use this as an intermediate step in converting to HTML; |
|
|
.Ic \&Nd |
.Ic \&Nd |
macro lacks the required argument. |
macro lacks the required argument. |
The title line of the manual will end after the dash. |
The title line of the manual will end after the dash. |
|
.It Sy "description line outside NAME section" |
|
.Pq mdoc |
|
An |
|
.Ic \&Nd |
|
macro appears outside the NAME section. |
|
The arguments are printed anyway and the following text is used for |
|
.Xr apropos 1 , |
|
but none of that behaviour is portable. |
.It Sy "sections out of conventional order" |
.It Sy "sections out of conventional order" |
.Pq mdoc |
.Pq mdoc |
A standard section occurs after another section it usually precedes. |
A standard section occurs after another section it usually precedes. |