add an index to the spec that is intended for github use -it references the .md files, not the generated .html files