-
Notifications
You must be signed in to change notification settings - Fork 0
/
ndogen_syntax.ndg
126 lines (82 loc) · 2.72 KB
/
ndogen_syntax.ndg
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
NDOGEN - Natural text markup
=================================================================
Ndogen exposes documentation as data (JSON) instead of pre-rendered HTML.
This approach not only saves some bytes at transmission, it also allows
clients to individually render the result.
Block Elements
=================================================================
Paragraph
-----------------------------------------------------------------
A paragraph is simply one or more consecutive lines of text, separated
by one or more blank lines. Normal paragraphs should not be indented with
spaces or tabs.
Sections
-----------------------------------------------------------------
Sections, inspired by the Setext-style, are “underlined” using equal signs
(for first-level sections) and dashes (for second-level sections) or dots
(third-level sections).
For example:
$ Section 1
$ =============
$
$ Section 2
$ -------------
$
$ Section 3
$ .............
Unordered Lists
-----------------------------------------------------------------
Ndogen supports nested lists and hanging indents.
$ * Red
$ * Green
$ Additional Line
$ * Dark Green
$ * Light Green
$ * Blue
Ordered Lists
-----------------------------------------------------------------
$ # Red
$ # Green
$ Additional Line
$ # Dark Green
$ # Light Green
$ # Blue
Code Blocks
-----------------------------------------------------------------
Use preceded $-signs to denote code blocks.
$ $ $(function() {
$ $ ndogen.run();
$ $ });
Topics
-----------------------------------------------------------------
$ A Topic:
$
$ A subsequent paragraph,
$ with some text
Definitions
-----------------------------------------------------------------
$ First definition: The value can be a paragraph
$ or any other element.
$
$ Second definition: * Item 1
$ * Item 2
Span Elements
=================================================================
Links
-----------------------------------------------------------------
Links are ready to be used inline. Links can be references to local
anchors or external resources.
$ An external Link[http://quasipartikel.at].
$ For more than one word as the link name you have to use quotes.
$ "See here"[http://github.com/oliver----/ndogen]
$
$ This is a references to a local anchor [SomeAnchor]
Emphasized text
-----------------------------------------------------------------
$ _Single underscores_ or *single asterisks*
Strong text
-----------------------------------------------------------------
$ __Double underscores__ or **double asterisks**
Inline Code
-----------------------------------------------------------------
$ You can create an instance with `new Person()`