kjdev / hoextdown

Hoextdown is an extension to Hoedown
MIT License
23 stars 15 forks source link

Special attributes doc says use colon before attributes; colon is passed right through #15

Open douyo opened 9 years ago

douyo commented 9 years ago

The doc on special attributes mentions that you should use a colon in front of other attributes:

To add a other than id and class names, use a colon like this:

## The Site ##    {.main .shine #the-site :color=red}

The colon actually gets passed right through to the rendered HTML:

<h2 ... :color=red>

Also, instead of color, a standard HTML attribute should be used in the example. (It doesn't look like color is a standard attribute. This is extra confusing because color is a CSS property, so this example might be interpreted as "here's how you set a CSS property on an element".

douyo commented 9 years ago

This also needs to be clarified: if a colon is required, should a single colon be included before the rest of the attributes or should each attribute name be preceded by a colon?

A number of folks have been doing this:

{: class='button button-green'}
{: target="_blank" :}
{: class='button button-green' target='_blank'}