Markdown files for Manifold are made up of a header (containing metadata elements), an optional reference to a stylesheet, and the text of the document.
When uploading only a single Markdown document, the header can contain all of the metadata elements noted in the Document Metadata section. When part of a manifest upload, the only element that should be present in the document header is the title; the rest can be described in the manifest YAML file.
A Markdown header is created by enclosing the document’s metadata elements with three dashes (or hyphens) on the lines above and below the data:
Single Document Upload
--- title: title date: "2016-01-15" language: language rights: rights description: description creator: Rowan Ono creator: Danielle Idra contributor: Ida Davis ---
--- title: title ---
If you would like to associate a stylesheet with your Markdown file, you can include a link to it after the header, as shown in the example here.
--- title: Section 1.1a --- <link rel="stylesheet" type="text/css" media="all" href="markdown_styles.css" /> Some text.
The stylesheet should be formatted and saved as a .css and compressed (or zipped) along with the Markdown.
You can also add a stylesheet after upload, in lieu of or in addition to any stylesheet you include here. See the Texts section for details on how to add stylesheets to already ingested texts.
Authors can embed media assets, such as images, audio, and video into their content, referencing them in keeping with standard practice:
Call-outs to images in the code can be formatted like this:
Some text. ![Image Alt-Text](godzilla.jpg) Some more text.
The directory that would be compressed for upload would include the Markdown file, image file, and any associated stylesheet.
Audio and Video
Markdown does not have specific syntax to embed audio or video content, but given it’s relationship to HTML, author’s can inject HTML code into a Markdown document and get the expected results. As such, by using the same coding as described in the HTML section below, authors can add audio and video, respectively.