| Index: bower_components/marked/doc/broken.md
|
| diff --git a/bower_components/marked/doc/broken.md b/bower_components/marked/doc/broken.md
|
| deleted file mode 100644
|
| index 7bfa49e8a9adf99afdeb8c6fcfcbc54f059445c2..0000000000000000000000000000000000000000
|
| --- a/bower_components/marked/doc/broken.md
|
| +++ /dev/null
|
| @@ -1,426 +0,0 @@
|
| -# Markdown is broken
|
| -
|
| -I have a lot of scraps of markdown engine oddities that I've collected over the
|
| -years. What you see below is slightly messy, but it's what I've managed to
|
| -cobble together to illustrate the differences between markdown engines, and
|
| -why, if there ever is a markdown specification, it has to be absolutely
|
| -thorough. There are a lot more of these little differences I have documented
|
| -elsewhere. I know I will find them lingering on my disk one day, but until
|
| -then, I'll continue to add whatever strange nonsensical things I find.
|
| -
|
| -Some of these examples may only mention a particular engine compared to marked.
|
| -However, the examples with markdown.pl could easily be swapped out for
|
| -discount, upskirt, or markdown.js, and you would very easily see even more
|
| -inconsistencies.
|
| -
|
| -A lot of this was written when I was very unsatisfied with the inconsistencies
|
| -between markdown engines. Please excuse the frustration noticeable in my
|
| -writing.
|
| -
|
| -## Examples of markdown's "stupid" list parsing
|
| -
|
| -```
|
| -$ markdown.pl
|
| -
|
| - * item1
|
| -
|
| - * item2
|
| -
|
| - text
|
| -^D
|
| -<ul>
|
| -<li><p>item1</p>
|
| -
|
| -<ul>
|
| -<li>item2</li>
|
| -</ul>
|
| -
|
| -<p><p>text</p></li>
|
| -</ul></p>
|
| -```
|
| -
|
| -
|
| -```
|
| -$ marked
|
| - * item1
|
| -
|
| - * item2
|
| -
|
| - text
|
| -^D
|
| -<ul>
|
| -<li><p>item1</p>
|
| -<ul>
|
| -<li>item2</li>
|
| -</ul>
|
| -<p>text</p>
|
| -</li>
|
| -</ul>
|
| -```
|
| -
|
| -Which looks correct to you?
|
| -
|
| -- - -
|
| -
|
| -```
|
| -$ markdown.pl
|
| -* hello
|
| - > world
|
| -^D
|
| -<p><ul>
|
| -<li>hello</p>
|
| -
|
| -<blockquote>
|
| - <p>world</li>
|
| -</ul></p>
|
| -</blockquote>
|
| -```
|
| -
|
| -```
|
| -$ marked
|
| -* hello
|
| - > world
|
| -^D
|
| -<ul>
|
| -<li>hello<blockquote>
|
| -<p>world</p>
|
| -</blockquote>
|
| -</li>
|
| -</ul>
|
| -```
|
| -
|
| -Again, which looks correct to you?
|
| -
|
| -- - -
|
| -
|
| -EXAMPLE:
|
| -
|
| -```
|
| -$ markdown.pl
|
| -* hello
|
| - * world
|
| - * hi
|
| - code
|
| -^D
|
| -<ul>
|
| -<li>hello
|
| -<ul>
|
| -<li>world</li>
|
| -<li>hi
|
| - code</li>
|
| -</ul></li>
|
| -</ul>
|
| -```
|
| -
|
| -The code isn't a code block even though it's after the bullet margin. I know,
|
| -lets give it two more spaces, effectively making it 8 spaces past the bullet.
|
| -
|
| -```
|
| -$ markdown.pl
|
| -* hello
|
| - * world
|
| - * hi
|
| - code
|
| -^D
|
| -<ul>
|
| -<li>hello
|
| -<ul>
|
| -<li>world</li>
|
| -<li>hi
|
| - code</li>
|
| -</ul></li>
|
| -</ul>
|
| -```
|
| -
|
| -And, it's still not a code block. Did you also notice that the 3rd item isn't
|
| -even its own list? Markdown screws that up too because of its indentation
|
| -unaware parsing.
|
| -
|
| -- - -
|
| -
|
| -Let's look at some more examples of markdown's list parsing:
|
| -
|
| -```
|
| -$ markdown.pl
|
| -
|
| - * item1
|
| -
|
| - * item2
|
| -
|
| - text
|
| -^D
|
| -<ul>
|
| -<li><p>item1</p>
|
| -
|
| -<ul>
|
| -<li>item2</li>
|
| -</ul>
|
| -
|
| -<p><p>text</p></li>
|
| -</ul></p>
|
| -```
|
| -
|
| -Misnested tags.
|
| -
|
| -
|
| -```
|
| -$ marked
|
| - * item1
|
| -
|
| - * item2
|
| -
|
| - text
|
| -^D
|
| -<ul>
|
| -<li><p>item1</p>
|
| -<ul>
|
| -<li>item2</li>
|
| -</ul>
|
| -<p>text</p>
|
| -</li>
|
| -</ul>
|
| -```
|
| -
|
| -Which looks correct to you?
|
| -
|
| -- - -
|
| -
|
| -```
|
| -$ markdown.pl
|
| -* hello
|
| - > world
|
| -^D
|
| -<p><ul>
|
| -<li>hello</p>
|
| -
|
| -<blockquote>
|
| - <p>world</li>
|
| -</ul></p>
|
| -</blockquote>
|
| -```
|
| -
|
| -More misnested tags.
|
| -
|
| -
|
| -```
|
| -$ marked
|
| -* hello
|
| - > world
|
| -^D
|
| -<ul>
|
| -<li>hello<blockquote>
|
| -<p>world</p>
|
| -</blockquote>
|
| -</li>
|
| -</ul>
|
| -```
|
| -
|
| -Again, which looks correct to you?
|
| -
|
| -- - -
|
| -
|
| -# Why quality matters - Part 2
|
| -
|
| -``` bash
|
| -$ markdown.pl
|
| -* hello
|
| - > world
|
| -^D
|
| -<p><ul>
|
| -<li>hello</p>
|
| -
|
| -<blockquote>
|
| - <p>world</li>
|
| -</ul></p>
|
| -</blockquote>
|
| -```
|
| -
|
| -``` bash
|
| -$ sundown # upskirt
|
| -* hello
|
| - > world
|
| -^D
|
| -<ul>
|
| -<li>hello
|
| -> world</li>
|
| -</ul>
|
| -```
|
| -
|
| -``` bash
|
| -$ marked
|
| -* hello
|
| - > world
|
| -^D
|
| -<ul><li>hello <blockquote><p>world</p></blockquote></li></ul>
|
| -```
|
| -
|
| -Which looks correct to you?
|
| -
|
| -- - -
|
| -
|
| -See: https://github.com/evilstreak/markdown-js/issues/23
|
| -
|
| -``` bash
|
| -$ markdown.pl # upskirt/markdown.js/discount
|
| -* hello
|
| - var a = 1;
|
| -* world
|
| -^D
|
| -<ul>
|
| -<li>hello
|
| -var a = 1;</li>
|
| -<li>world</li>
|
| -</ul>
|
| -```
|
| -
|
| -``` bash
|
| -$ marked
|
| -* hello
|
| - var a = 1;
|
| -* world
|
| -^D
|
| -<ul><li>hello
|
| -<pre>code>var a = 1;</code></pre></li>
|
| -<li>world</li></ul>
|
| -```
|
| -
|
| -Which looks more reasonable? Why shouldn't code blocks be able to appear in
|
| -list items in a sane way?
|
| -
|
| -- - -
|
| -
|
| -``` bash
|
| -$ markdown.js
|
| -<div>hello</div>
|
| -
|
| -<span>hello</span>
|
| -^D
|
| -<p><div>hello</div></p>
|
| -
|
| -<p><span>hello</span></p>
|
| -```
|
| -
|
| -``` bash
|
| -$ marked
|
| -<div>hello</div>
|
| -
|
| -<span>hello</span>
|
| -^D
|
| -<div>hello</div>
|
| -
|
| -
|
| -<p><span>hello</span>
|
| -</p>
|
| -```
|
| -
|
| -- - -
|
| -
|
| -See: https://github.com/evilstreak/markdown-js/issues/27
|
| -
|
| -``` bash
|
| -$ markdown.js
|
| -[](/link)
|
| -^D
|
| -<p><a href="/image)](/link">](/link)
|
| -^D
|
| -<p><a href="/link"><img src="/image" alt="an image"></a>
|
| -</p>
|
| -```
|
| -
|
| -- - -
|
| -
|
| -See: https://github.com/evilstreak/markdown-js/issues/24
|
| -
|
| -``` bash
|
| -$ markdown.js
|
| -> a
|
| -
|
| -> b
|
| -
|
| -> c
|
| -^D
|
| -<blockquote><p>a</p><p>bundefined> c</p></blockquote>
|
| -```
|
| -
|
| -``` bash
|
| -$ marked
|
| -> a
|
| -
|
| -> b
|
| -
|
| -> c
|
| -^D
|
| -<blockquote><p>a
|
| -
|
| -</p></blockquote>
|
| -<blockquote><p>b
|
| -
|
| -</p></blockquote>
|
| -<blockquote><p>c
|
| -</p></blockquote>
|
| -```
|
| -
|
| -- - -
|
| -
|
| -``` bash
|
| -$ markdown.pl
|
| -* hello
|
| - * world
|
| - how
|
| -
|
| - are
|
| - you
|
| -
|
| - * today
|
| -* hi
|
| -^D
|
| -<ul>
|
| -<li><p>hello</p>
|
| -
|
| -<ul>
|
| -<li>world
|
| -how</li>
|
| -</ul>
|
| -
|
| -<p>are
|
| -you</p>
|
| -
|
| -<ul>
|
| -<li>today</li>
|
| -</ul></li>
|
| -<li>hi</li>
|
| -</ul>
|
| -```
|
| -
|
| -``` bash
|
| -$ marked
|
| -* hello
|
| - * world
|
| - how
|
| -
|
| - are
|
| - you
|
| -
|
| - * today
|
| -* hi
|
| -^D
|
| -<ul>
|
| -<li><p>hello</p>
|
| -<ul>
|
| -<li><p>world
|
| -how</p>
|
| -<p>are
|
| -you</p>
|
| -</li>
|
| -<li><p>today</p>
|
| -</li>
|
| -</ul>
|
| -</li>
|
| -<li>hi</li>
|
| -</ul>
|
| -```
|
|
|