Description
An Option Lists are a part of reStructuredText specs. Superficially looking I couldn't find any information on when it was included in the specs.
The following block (that adheres to the Option List specs) is currently read as a Definition List and a paragraph.
-a Line
Next-line
-b arg Next-option[ DefinitionList
[ ( [ Str "-a" , Space , Str "Line" ]
, [ [ Para [ Str "Next-line" ] ] ]
)
]
, Para
[ Str "-b" , Space , Str "arg" , Space , Str "Next-option" ]
]
I'm not sure if it's a bug or a feature request, as I'm not particularly interested in this part of the specs being supported. This issue is supposed to document pandoc not following the specification. I'm OK with closing it as not-planned or tagging as low-importance.
The main motivation for raising this issue is that I couldn't find any indication that this feature is not supported in pandoc docs. I think the docs should include a section which lists the cases where pandoc does not follow the specs of the supported formats (at least for readers) and known limitations of pandoc's native representation. If it's OK with the maintainers, I can either create a separate issue with this request or start small and make a PR with this addition to the docs.