toc - Table Of Contents auto include option

This may be related to https://github.com/trentm/python-markdown2/issues/49 which asks about usage.

I'm currently using the toc extension like this:

html_text = markdown2.markdown(plain_text, extras=['code-friendly', 'toc'])
table_of_contents_html = html_text.toc_html
html_text = str(html_text)  # or maybe Unicode.... don't get hung up on this line.....
if table_of_contents_html:
    # inject Table Of Contents into document
    TOC_MARKER = '<!--TOC-->'
    html_text = html_text.replace(TOC_MARKER, table_of_contents_html)

Basically I use <!--TOC--> as a marker in my document for where I want the table to appear, the trick is to use a marker that markdown2 won't alter (e.g. a regular word is likely to be wrapped in a p tag).

Is there any chance this sort of approach could be built into to the toc extension (or a new auto_toc extension)? Posting issue to get feedback (I can carry on using my approach above).

Start with the toc extension and the markdown2.markdown path described in the example, tracing how toc_html and the marker are handled. Define the desired automatic insertion behavior and confirm that generated HTML places the table at the marker without requiring manual replacement.