uml is a markup is a (mostly) line based markup langauge. it mostly exists to be 'rendered' or exported into other markup languages. as such it is the 'lowest common denominator' of all these markup languages. its features include
> it was the best of times, it was the worst of times...
links:
= https://http.cat
link with description:
= https://http.cat cute cats
comment:
% here's a comment that will not be rendered!
lists:
- one
- two
* three
* four
- five
codeblocks:
```
#include <stdio.h>
int main(void) { return 0; }
```
codeblock with description:
```description
#include <stdio.h>
int main(void) { return 0; }
```
tables:
| ticker | value | increase
| TILD | 102.3 | +10.39
| EVER | 403.1 | +493.2
| SECO | 302.1 | -932.6
| OL | 6092.1 | -4.3
inline links:
hello there, here's a [link](https://example.com)
rendering considerations
========================
uml was designed for rendering into gemtext, gophermaps, simple html, and plain text, in addition to regular markdown.
for rendering into gophermaps, plaintext, and gemtext, it is recommended that inline links be rendered using some sort of reference system:
+--------------| Input text |--+
| Here's a line with [inline |
| links](https://example.com). |
+-------------| Output text |--+
| Here's a line with inline |
| links [1]. |
| |
| [1]: https://example.com |
+------------------------------+
tables can be rendered like so:
+--------------------------| Input text |--+
| | roses | are | red |
| | violets | are | blue |
| | tables | are | cool |
+-------------------------| Output text |--+
| |
| +----------------------+ |
| | roses | are | red | |
| | violets | are | blue | |
| | tables | are | cool | |
| +----------------------+ |
| |
+------------------------------------------+
uml.py usage
============
uml.py takes no arguments and just listens on stdin. it tokenizes the implimented parts of the markup language until an EOF is reached, in which case the program prints the results of the tokenization.
