MultiMarkdown User's Guide
by Fletcher T. Penney
table of contents
MultiMarkdown User's Guide
table of contents
file-top metadata
Introduction to MultiMarkdown
What is Markdown?
What is MultiMarkdown?
How do I use MultiMarkdown?
Where can I find MultiMarkdown?
Where can I get more information about MultiMarkdown?
Quickstart Guide to MultiMarkdown
General Instructions
MultiMarkdown Syntax Guide
Metadata
the Address
Author
Affiliation
Base Header Level
Base URL -- Deprecated
Bibliography Title
Bibliography Style
BibTeX
Chapterstyle
Copyright
CSS
Date
Email
Format
Keywords
Language
LaTeX XSLT
Pagestyle
Phone
the Recipient
Recipient Address
Revision
RTF XSLT
Subtitle
Title
Use WikiLinks -- Deprecated
Web
XHTML Header
XHTML XSLT
XMP
XSLT File -- Deprecated
Automatic Cross-References
Overview of MultiMarkdown
Image Support
Anchor and Image Attributes
WikiLinks -- Deprecated
Footnotes
Tables
Bibliography Support
MultiMarkdown References
External References
Multiple Citations
BibTeX Support
Advanced Citations with natbib
Math Syntax
Introduction to Math support
Math Syntax in MultiMarkdown
Superscripts
MathML Difficulties
Definition Lists
Appendices
Glossaries
Poetry Mode
Miscellanea
MultiMarkdown and LaTeX
Advanced Features and Customization
How do I find out about feature x?
How do I customize MultiMarkdown?
Where do I dig in the MultiMarkdown package to find out more?
Component Software
MultiMarkdown for the win
SmartyPants
Text::ASCIIMathML
ASCIIMathPHP -- Deprecated
XSLTMathML
Applications That Support MultiMarkdown
Movable Type
MultiMarkdown Drag and Drop
Scrivener
OmniOutliner
TextMate
Using Scrivener and TextMate Together
The "Common" MultiMarkdown approach
Create Your Own
Technical Issues
XML Namespace Issues
XeLaTeX Tips
Acknowledgments
Known Issues
Things to Do
Version History
file-top metadata
Title: MultiMarkdown User's Guide
Subtitle: Version 2.0.b6
Author: Fletcher T. Penney
Web: http://fletcherpenney.net/
Copyright: 2005-2009 Fletcher T. Penney.
This work is licensed under a Creative Commons License.
http://creativecommons.org/licenses/by-nc-sa/3.0/
XMP: CCAttributionShareAlike
Keywords: Markdown
LaTeX
TeX
PDF
XHTML
XSLT
Oddmuse
OmniOutliner
MultiMarkdown
RTF
TextMate
Version: 2.0.b6
Base Header Level: 2
CSS: http://fletcherpenney.net/document.css
XHTML XSLT: xhtml-toc-h2.xslt
# Introduction to MultiMarkdown #
This document is an introduction to [MultiMarkdown][] --- what it is, how to
use it, how you can help make it better. This document exists in multiple
formats: a plain text document, a pdf, a [Scrivener][] document,
etc. Find the format that best suits your needs, or create your own. That is
what MultiMarkdown was designed to be used for!
[MultiMarkdown]: http://fletcherpenney.net/MultiMarkdown
[Scrivener]: http://www.literatureandlatte.com/scrivener.html
## What is Markdown? #
To understand what MultiMarkdown is, you first should be familiar with
[Markdown]
(
zzzz://daringfireball.net/projects/markdown/
"Daring Fireball: Markdown"). The best description of what Markdown is comes from John Gruber's
Markdown web site:
> Markdown is a text-to-HTML conversion tool for web writers. Markdown
> allows you to write using an easy-to-read, easy-to-write plain text
> format, then convert it to structurally valid XHTML (or HTML).
> Thus, "Markdown" is two things: (1) a plain text formatting
> syntax; and (2) a software tool, written in Perl, that converts
> the plain text formatting to HTML. See the Syntax page for details
> pertaining to Markdown's formatting syntax. You can try it out,
> right now, using the online Dingus.
> The overriding design goal for Markdown's formatting syntax is to
> make it as readable as possible. The idea is that a Markdown-formatted
> document should be publishable as-is, as plain text, without looking
> like it's been marked up with tags or formatting instructions. While
> Markdown's syntax has been influenced by several existing
> text-to-HTML filters, the single biggest source of inspiration for
> Markdown's syntax is the format of plain text email. [#Gruber][]
[#Gruber]: Daring Fireball: Markdown.
http://daringfireball.net/projects/markdown/