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?

sounds like an excellent addition to the project, i recommend forking and creating pull request — Jed Schneider, Jul 13 '12 at 04:17
Hmm, I can't seem to find a repository for Markdown any where, I'm coming to the conclusion that it's not open source? And I'm feeling like this doesn't really belong in Docco, as docco doesn't actually do this sort of thing, it just interprets the markdown? Unless I'm mistaken? So not sure where it would go? — phenomnomnominal, Jul 14 '12 at 01:04

score 2 · Accepted Answer · answered Aug 18 '12 at 03:37

2

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.

answered Aug 18 '12 at 03:37

phenomnomnominal

1 Answers1