markdown-syntax.md:1:1:Markup: Syntax markdown-syntax.md:5:46:
  • Main
    • markdown-syntax.md:6:52:
  • Basics
    • markdown-syntax.md:7:36:
  • Syntax
    • markdown-syntax.md:9:59:
  • Dingus
    • markdown-syntax.md:34:49:**Note:** This document is itself written using Markup; you markdown-syntax.md:45:1:Markup is intended to be as easy-to-read and easy-to-write as is feasible. markdown-syntax.md:47:55:Readability, however, is emphasized above all else. A Markup-formatted markdown-syntax.md:50:1:Markup's syntax has been influenced by several existing text-to-HTML markdown-syntax.md:53:17:inspiration for Markup's syntax is the format of plain text email. markdown-syntax.md:62:14:To this end, Markup's syntax is comprised entirely of punctuation markdown-syntax.md:65:25:look like \*emphasis\*. Markup lists look like, well, lists. Even markdown-syntax.md:73:1:Markup's syntax is intended for one purpose: to be used as a markdown-syntax.md:76:1:Markup is not a replacement for HTML, or even close to it. Its markdown-syntax.md:80:22:insert. The idea for Markup is to make it easy to read, write, and markdown-syntax.md:81:44:edit prose. HTML is a *publishing* format; Markup is a *writing* markdown-syntax.md:82:15:format. Thus, Markup's formatting syntax only addresses issues that markdown-syntax.md:85:39:For any markup that is not covered by Markup's syntax, you simply markdown-syntax.md:87:37:indicate that you're switching from Markup to HTML; you just use markdown-syntax.md:93:38:not be indented with tabs or spaces. Markup is smart enough not markdown-syntax.md:96:40:For example, to add an HTML table to a Markup article: markdown-syntax.md:108:11:Note that Markup formatting syntax is not processed within block-level markdown-syntax.md:109:32:HTML tags. E.g., you can't use Markup-style `*emphasis*` inside an markdown-syntax.md:113:20:used anywhere in a Markup paragraph, list item, or header. If you markdown-syntax.md:114:45:want, you can even use HTML tags instead of Markup formatting; e.g. if markdown-syntax.md:115:59:you'd prefer to use HTML `` or `` tags instead of Markup's markdown-syntax.md:118:31:Unlike block-level HTML tags, Markup syntax *is* processed within markdown-syntax.md:144:1:Markup allows you to use these characters naturally, taking care of markdown-syntax.md:153:5:and Markup will leave it alone. But if you write: markdown-syntax.md:157:1:Markup will translate it to: markdown-syntax.md:161:20:Similarly, because Markup supports [inline HTML](#html), if you use markdown-syntax.md:162:45:angle brackets as delimiters for HTML tags, Markup will treat them as markdown-syntax.md:167:1:Markup will translate it to: markdown-syntax.md:171:17:However, inside Markup code spans and blocks, angle brackets and markdown-syntax.md:173:1:Markup to write about HTML code. (As opposed to raw HTML, which is a markdown-syntax.md:192:6:that Markup supports "hard-wrapped" text paragraphs. This differs markdown-syntax.md:197:57:When you *do* want to insert a `
    ` break tag using Markup, you markdown-syntax.md:201:57:"every line break is a `
    `" rule wouldn't work for Markup. markdown-syntax.md:202:1:Markup's email-style [blockquoting][bq] and multi-paragraph [list items][l] markdown-syntax.md:212:1:Markup supports two styles of headers, [Setext] [1] and [atx] [2]. markdown-syntax.md:249:1:Markup uses email-style `>` characters for blockquoting. If you're markdown-syntax.md:251:36:know how to create a blockquote in Markup. It looks best if you hard markdown-syntax.md:261:1:Markup allows you to be lazy and only put the `>` before the first markdown-syntax.md:280:31:Blockquotes can contain other Markup elements, including headers, lists, markdown-syntax.md:299:1:Markup supports ordered (numbered) and unordered (bulleted) lists. markdown-syntax.md:327:40:list have no effect on the HTML output Markup produces. The HTML markdown-syntax.md:328:1:Markup produces from the above list is: markdown-syntax.md:336:34:If you instead wrote the list in Markup like this: markdown-syntax.md:349:45:you can use ordinal numbers in your ordered Markup lists, so that markdown-syntax.md:354:54:list with the number 1. At some point in the future, Markup may support markdown-syntax.md:377:45:If list items are separated by blank lines, Markup will wrap the markdown-syntax.md:418:29:paragraphs, but here again, Markup will allow you to be markdown-syntax.md:461:44:of a code block are interpreted literally. Markup wraps a code block markdown-syntax.md:464:28:To produce a code block in Markup, simply indent every line of the markdown-syntax.md:471:1:Markup will generate: markdown-syntax.md:501:48:easy to include example HTML source code using Markup -- just paste markdown-syntax.md:502:23:it and indent it, and Markup will handle the hassle of encoding the markdown-syntax.md:516:9:Regular Markup syntax is not processed within code blocks. E.g., markdown-syntax.md:518:23:it's also easy to use Markup to write about Markup's own syntax. markdown-syntax.md:518:47:it's also easy to use Markup to write about Markup's own syntax. markdown-syntax.md:546:1:Markup supports two style of links: *inline* and *reference*. markdown-syntax.md:602:35:**Note:** There is a known bug in Markup.pl 1.0.1 which prevents markdown-syntax.md:615:58:Link definitions are only used for creating links during Markup markdown-syntax.md:647:49:Link definitions can be placed anywhere in your Markup document. I markdown-syntax.md:678:1:Markup's inline link style: markdown-syntax.md:692:6:With Markup's reference-style links, a source document much more markdown-syntax.md:701:1:Markup treats asterisks (`*`) and underscores (`_`) as indicators of markdown-syntax.md:779:7:tags. Markup will turn this: markdown-syntax.md:803:1:Markup uses an image syntax that is intended to resemble the syntax markdown-syntax.md:830:21:As of this writing, Markup has no syntax for specifying the markdown-syntax.md:842:1:Markup supports a shortcut style for creating "automatic" links for URLs and email addresses: simply surround the URL or email address with angle brackets. What this means is that if you want to show the actual text of a URL or email address, and also have it be a clickable link, you can do this: markdown-syntax.md:846:1:Markup will turn this into: markdown-syntax.md:851:1:Markup will also perform a bit of randomized decimal and hex markdown-syntax.md:853:24:spambots. For example, Markup will turn this: markdown-syntax.md:875:1:Markup allows you to use backslash escapes to generate literal markdown-syntax.md:876:58:characters which would otherwise have special meaning in Markup's markdown-syntax.md:883:1:Markup provides backslash escapes for the following characters: