Doccy is a simple brace based markup language, an alternative to writing HTML for people who enjoy the power and flexibility but do not enjoy writing it.
Any text contained within specific contexts will be treated as one or more paragraphs if separated by two or more line breaks and it contains only inline elements.
```doccy This is a paragraph.
{h1: This is a header.}
And this is another. ```
Renders as:
```html
This is a paragraph.
And this is another.
```
The following elements also automatically wrap paragraphs: article, aside, blockquote, div, fieldset, footer, form, header, hgroup, main and section.
```doccy {blockquote: This is a paragraph.
And this is another.} ```
Renders as:
```html
This is a paragraph.
And this is another.
```
Anything between two curley-braces is considered an element if:
:).For example, the following are all valid:
doccy
{h1:Top-level heading}
{p : A paragraph}
There is one exception to this rule, line breaks (<br>) can be written as:
doccy
{br}
Anything between the opening curley-brace and colon is considered an attribute if:
@, #, %, .,[a-zA-Z][a-zA-Z0-9]*)A named attribute with a value looks like:
doccy
{h1 @class main header: Header}
Renders as:
```html
```
Without a value:
doccy
{input @required}
Renders as:
html
<input required>
Values containing special characters must be escaped:
doccy
{h1 @test Bad characters\: \@\#\%\.\{\}: ...}
Renders as: ```html
```
A shorthand for data- attributes:
doccy
{pre %lang html: ...}
{pre %html: ...}
Renders as:
```html
...
...
```
As with named attributes, special characters must be escaped.
A shorthand for class="..." attributes:
doccy
{h1.main.header: Header}
Renders as:
```html
```
A shorthand for id="..." attributes:
doccy
{h1#main: Header}
Renders as:
```html
```
```rust extern crate doccy;
use doccy::doccytohtml;
fn main() { match doccytohtml("your document here") { Ok(html) => println!("{:?}", html), //
your document here
Err(error) => {} }; } ```