Rename REAMDE to README.md
[nit.git] / lib / markdown / README.md
1 A markdown parser for Nit.
2
3 Markdown documentation can be found in http://daringfireball.net/projects/markdown/.
4 This parser is inspired by the famous TxtMark for Java (https://github.com/rjeschke/txtmark).
5
6 ## Usage
7
8 `nitmd` can be used as a standalone tool:
9
10         $ nitmd file.md
11
12 Or you can use it programmatically by importing the `markdown` module.
13
14 ## Differences with Markdown specification
15
16 This parser passes all tests inside http://daringfireball.net/projects/downloads/MarkdownTest_1.0_2007-05-09.tgz execpt of two:
17
18 1. Images.text: fails because this parser doesn't produce empty 'title' image attributes.
19 2. Literal quotes in titles.text: because markdown accepts unescaped quotes in titles and this is wrong.
20
21 ## Testing
22
23 The NitUnit test suite can be found in `test_markdown.nit`.
24
25 Minimalists tests are prefixed with `process_*`. All tests from daringfireball are prefixed with `process_daring*`.
26
27 Run the test suite:
28
29         $ nitunit lib/markdown/markdown.nit -t lib/markdown/test_markdown.nit