murkdown 0.1.1

An experimental semantic markup language and static site generator for composing and decomposing hypertext documents
Documentation 
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
125
126
127
128
129
130
131
132
133
134
135
136

RULES FOR markdown PRODUCE text/markdown

/* ------------------------------------------------ */
PREPROCESS RULES:
[...DATE...]$
  EXEC "date" TO text/plain AS "date"
  PUSH src "exec?:date"

[...EXEC...]$
  PUSH src "exec?:run"

[...EXEC...] [SEC]$
  SET stdin "\v"
  EXEC "bash" TO text/plain AS "run"

[...UML...]$
  PUSH ref "exec:plantuml.png"

[...UML...] [SEC]$
  SET stdin "\v"
  EXEC "plantuml -pipe -tpng" TO image/png AS "plantuml.png"

[...IMAGE...]$
  IS REF-BY-COPY

/* ------------------------------------------------ */
COMPILE RULES:
/* root */
^[...]$
  SET join "\n"

^[...] [SEC...] [...]$
  IS COMPOSABLE
  SET spacer " "

^[...] [SEC...] [CODE] [SEC...]$
  IS COMPOSABLE
  SET spacer ""

/* code section */
[...CODE...] [SEC...]$
  WRITEALL prefix
  WRITE spacer
  WRITE "```$language\n"
  YIELD
  WRITE "\n"
  WRITEALL prefix
  WRITE spacer
  WRITE "```\n"

/* figure block */
[...FIGURE...]$
  YIELD

/* root image block*/
^[...] [SEC...] ([ FIGURE ] [ SEC ] )?[...IMAGE...]$
  WRITEALL prefix
  WRITE "!["
  YIELD
  WRITE prefix
  WRITE "]($ref)"

/* image block */
[...IMAGE...]$
  WRITEALL prefix
  WRITE " !["
  YIELD
  WRITE "]($ref)"

/* callout block */
[...TIP...]$
  PUSH prefix "\m"
  WRITEALL prefix
  WRITE " [!TIP]\n"
  YIELD
  POP prefix

/* plain code block */
[CODE]$
  SET language "$language"
  YIELD
  SET language ""

/* code block */
[...CODE...]$
  SET language "$language"
  PUSH prefix "\m"
  YIELD
  POP prefix
  SET language ""

/* root block */
^[...] [SEC...] [...]$
  PUSH prefix "\m"
  YIELD
  POP prefix

/* heading block */
[...] [SEC...] [...HEADING...]$
  PUSH prefix "\m"
  YIELD
  POP prefix

/* nested block */
[...] [SEC...] [...]$
  PUSH prefix " \m"
  YIELD
  POP prefix

/* root plain code line */
^[...] [SEC...] [CODE] [SEC...] LINE$
  IS UNESCAPED_VALUE
  WRITEALL prefix
  WRITE "\v"

/* code line */
[...CODE...] [SEC...] LINE$
  IS UNESCAPED_VALUE
  WRITEALL prefix
  WRITE " \v"

/* image line */
[...IMAGE...] [SEC...] LINE$
  WRITE "\v"

/* other */
^[...] [SEC...] LINE$
  IS UNESCAPED_VALUE
  WRITE prefix
  WRITE "\v"

LINE$
  IS UNESCAPED_VALUE
  WRITEALL prefix
  WRITE spacer
  WRITE "\v"