The following is an idea for an enhancement to Markdown that allows for "YAML frontmatter" intersperced throughout the document. This will allow you to write standard markdown while also supporting more complex data types where necessary.
The idea incldues the ability to "class" your YAML to a specific object type. For example, what follows is an image object that would be rendered according to the specs of the rendering engine.
----image
src: /path/to/image.png
caption: some markdown [caption](#)
credit: a person's name
----
The rest of this file is garbage. This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at http://www.w3.org/TR/.
This document was produced by the CSS Working Group as a Proposed Recommendation.
A W3C Recommendation is a mature document that has been widely reviewed and has been shown to be implementable. W3C encourages everybody to implement this specification. Comments may be sent to the (archived) public mailing list www-style@w3.org (see instructions). When sending e-mail, please put the text “css3-selectors” in the subject, preferably like this: “[css3-selectors] …summary of comment…”
This document has been reviewed by W3C Members, by software developers, and by other W3C groups and interested parties, and is endorsed by the Director as a W3C Recommendation. It is a stable document and may be used as reference material or cited from another document. W3C's role in making the Recommendation is to draw attention to the specification and to promote its widespread deployment. This enhances the functionality and interoperability of the Web.
This document was produced by a group operating under the 5 February 2004 W3C Patent Policy. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.
A separate implementation report contains a test suite and shows several implementations of the specification.
This document is the same as the previous, Proposed Recommendation version, except for editorial changes to the front matter, and updating of references.