summaryrefslogtreecommitdiffstats
path: root/content/9thPK7O3xn/pages
diff options
context:
space:
mode:
Diffstat (limited to 'content/9thPK7O3xn/pages')
-rw-r--r--content/9thPK7O3xn/pages/design-test.md315
1 files changed, 0 insertions, 315 deletions
diff --git a/content/9thPK7O3xn/pages/design-test.md b/content/9thPK7O3xn/pages/design-test.md
deleted file mode 100644
index 2367513..0000000
--- a/content/9thPK7O3xn/pages/design-test.md
+++ /dev/null
@@ -1,315 +0,0 @@
1---
2title: Design Test
3---
4
5- [Overview](#overview)
6 - [Philosophy](#philosophy)
7- [Block Elements](#block-elements)
8 - [Paragraphs and Line Breaks](#paragraphs-and-line-breaks)
9 - [Headers](#headers)
10 - [Blockquotes](#blockquotes)
11 - [Lists](#lists)
12 - [Code Blocks](#code-blocks)
13- [Span Elements](#span-elements)
14 - [Links](#links)
15 - [Emphasis](#emphasis)
16 - [Code](#code)
17
18----
19
20## Overview
21
22### Philosophy
23
24Markdown is intended to be as easy-to-read and easy-to-write as is feasible.
25
26Readability, however, is emphasized above all else. A Markdown-formatted
27document should be publishable as-is, as plain text, without looking
28like it's been marked up with tags or formatting instructions. While
29Markdown's syntax has been influenced by several existing text-to-HTML
30filters -- including [Setext](http://docutils.sourceforge.net/mirror/setext.html), [atx](http://www.aaronsw.com/2002/atx/), [Textile](http://textism.com/tools/textile/), [reStructuredText](http://docutils.sourceforge.net/rst.html),
31[Grutatext](http://www.triptico.com/software/grutatxt.html), and [EtText](http://ettext.taint.org/doc/) -- the single biggest source of
32inspiration for Markdown's syntax is the format of plain text email.
33
34## Block Elements
35
36### Paragraphs and Line Breaks
37
38A paragraph is simply one or more consecutive lines of text, separated
39by one or more blank lines. (A blank line is any line that looks like a
40blank line -- a line containing nothing but spaces or tabs is considered
41blank.) Normal paragraphs should not be indented with spaces or tabs.
42
43The implication of the "one or more consecutive lines of text" rule is
44that Markdown supports "hard-wrapped" text paragraphs. This differs
45significantly from most other text-to-HTML formatters (including Movable
46Type's "Convert Line Breaks" option) which translate every line break
47character in a paragraph into a `<br />` tag.
48
49When you *do* want to insert a `<br />` break tag using Markdown, you
50end a line with two or more spaces, then type return.
51
52### Headers
53
54Markdown supports two styles of headers, [Setext] [1] and [atx] [2].
55
56Optionally, you may "close" atx-style headers. This is purely
57cosmetic -- you can use this if you think it looks better. The
58closing hashes don't even need to match the number of hashes
59used to open the header. (The number of opening hashes
60determines the header level.)
61
62
63### Blockquotes
64
65Markdown uses email-style `>` characters for blockquoting. If you're
66familiar with quoting passages of text in an email message, then you
67know how to create a blockquote in Markdown. It looks best if you hard
68wrap the text and put a `>` before every line:
69
70> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
71> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
72> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
73>
74> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
75> id sem consectetuer libero luctus adipiscing.
76
77Markdown allows you to be lazy and only put the `>` before the first
78line of a hard-wrapped paragraph:
79
80> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
81consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
82Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
83
84> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
85id sem consectetuer libero luctus adipiscing.
86
87Blockquotes can be nested (i.e. a blockquote-in-a-blockquote) by
88adding additional levels of `>`:
89
90> This is the first level of quoting.
91>
92> > This is nested blockquote.
93>
94> Back to the first level.
95
96Blockquotes can contain other Markdown elements, including headers, lists,
97and code blocks:
98
99> ## This is a header.
100>
101> 1. This is the first list item.
102> 2. This is the second list item.
103>
104> Here's some example code:
105>
106> return shell_exec("echo $input | $markdown_script");
107
108Any decent text editor should make email-style quoting easy. For
109example, with BBEdit, you can make a selection and choose Increase
110Quote Level from the Text menu.
111
112
113### Lists
114
115Markdown supports ordered (numbered) and unordered (bulleted) lists.
116
117Unordered lists use asterisks, pluses, and hyphens -- interchangably
118-- as list markers:
119
120* Red
121* Green
122* Blue
123
124is equivalent to:
125
126+ Red
127+ Green
128+ Blue
129
130and:
131
132- Red
133- Green
134- Blue
135
136Ordered lists use numbers followed by periods:
137
1381. Bird
1392. McHale
1403. Parish
141
142It's important to note that the actual numbers you use to mark the
143list have no effect on the HTML output Markdown produces. The HTML
144Markdown produces from the above list is:
145
146If you instead wrote the list in Markdown like this:
147
1481. Bird
1491. McHale
1501. Parish
151
152or even:
153
1543. Bird
1551. McHale
1568. Parish
157
158you'd get the exact same HTML output. The point is, if you want to,
159you can use ordinal numbers in your ordered Markdown lists, so that
160the numbers in your source match the numbers in your published HTML.
161But if you want to be lazy, you don't have to.
162
163To make lists look nice, you can wrap items with hanging indents:
164
165* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
166 Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
167 viverra nec, fringilla in, laoreet vitae, risus.
168* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
169 Suspendisse id sem consectetuer libero luctus adipiscing.
170
171But if you want to be lazy, you don't have to:
172
173* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
174Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
175viverra nec, fringilla in, laoreet vitae, risus.
176* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
177Suspendisse id sem consectetuer libero luctus adipiscing.
178
179List items may consist of multiple paragraphs. Each subsequent
180paragraph in a list item must be indented by either 4 spaces
181or one tab:
182
1831. This is a list item with two paragraphs. Lorem ipsum dolor
184 sit amet, consectetuer adipiscing elit. Aliquam hendrerit
185 mi posuere lectus.
186
187 Vestibulum enim wisi, viverra nec, fringilla in, laoreet
188 vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
189 sit amet velit.
190
1912. Suspendisse id sem consectetuer libero luctus adipiscing.
192
193It looks nice if you indent every line of the subsequent
194paragraphs, but here again, Markdown will allow you to be
195lazy:
196
197* This is a list item with two paragraphs.
198
199 This is the second paragraph in the list item. You're
200only required to indent the first line. Lorem ipsum dolor
201sit amet, consectetuer adipiscing elit.
202
203* Another item in the same list.
204
205To put a blockquote within a list item, the blockquote's `>`
206delimiters need to be indented:
207
208* A list item with a blockquote:
209
210 > This is a blockquote
211 > inside a list item.
212
213To put a code block within a list item, the code block needs
214to be indented *twice* -- 8 spaces or two tabs:
215
216* A list item with a code block:
217
218 <code goes here>
219
220### Code Blocks
221
222Pre-formatted code blocks are used for writing about programming or
223markup source code. Rather than forming normal paragraphs, the lines
224of a code block are interpreted literally. Markdown wraps a code block
225in both `<pre>` and `<code>` tags.
226
227To produce a code block in Markdown, simply indent every line of the
228block by at least 4 spaces or 1 tab.
229
230This is a normal paragraph:
231
232 This is a code block.
233
234Here is an example of AppleScript:
235
236 tell application "Foo"
237 beep
238 end tell
239
240A code block continues until it reaches a line that is not indented
241(or the end of the article).
242
243Within a code block, ampersands (`&`) and angle brackets (`<` and `>`)
244are automatically converted into HTML entities. This makes it very
245easy to include example HTML source code using Markdown -- just paste
246it and indent it, and Markdown will handle the hassle of encoding the
247ampersands and angle brackets. For example, this:
248
249 <div class="footer">
250 &copy; 2004 Foo Corporation
251 </div>
252
253Regular Markdown syntax is not processed within code blocks. E.g.,
254asterisks are just literal asterisks within a code block. This means
255it's also easy to use Markdown to write about Markdown's own syntax.
256
257```
258tell application "Foo"
259 beep
260end tell
261```
262
263## Span Elements
264
265### Links
266
267Markdown supports two style of links: *inline* and *reference*.
268
269In both styles, the link text is delimited by [square brackets].
270
271To create an inline link, use a set of regular parentheses immediately
272after the link text's closing square bracket. Inside the parentheses,
273put the URL where you want the link to point, along with an *optional*
274title for the link, surrounded in quotes. For example:
275
276This is [an example](http://example.com/) inline link.
277
278[This link](http://example.net/) has no title attribute.
279
280### Emphasis
281
282Markdown treats asterisks (`*`) and underscores (`_`) as indicators of
283emphasis. Text wrapped with one `*` or `_` will be wrapped with an
284HTML `<em>` tag; double `*`'s or `_`'s will be wrapped with an HTML
285`<strong>` tag. E.g., this input:
286
287*single asterisks*
288
289_single underscores_
290
291**double asterisks**
292
293__double underscores__
294
295### Code
296
297To indicate a span of code, wrap it with backtick quotes (`` ` ``).
298Unlike a pre-formatted code block, a code span indicates code within a
299normal paragraph. For example:
300
301Use the `printf()` function.
302
303---
304
305# Headline 1
306
307## Headline 2
308
309### Headline 3
310
311#### Headline 4
312
313##### Headline 5
314
315###### Headline 6