Naming sections with docco/markdown?

Question

Using CoffeeScript and Docco, sections are created in the generated HTML which can then be used as links eg.

geometry.html#section-82

Does anyone know if there is a way to name these sections so it could instead be (for example):

geometry.html#vector

EDIT: It would seem this can be achieved by simply adding in the HTML manually:

**MARKDOWN**
# ## <section id='vector'>Vector:</section>

but is there any other, perhaps more elegant ways?

Answer 1

Currently the best way I can find to do this is as follows:

# ## <section id='vector'>Vector:</section>

It seems to work pretty well, wish I could add it to Markdown though.