Jigsaw: Table of Contents

[diazgilberto]

Hi Jigsaw team,

I'm used to the read the docs tool to write Markdown to create documentation. However, I'm enjoying this tool and we decide to use it at my work palce.

Inside a markdown file, right after the main title at the top, I can insert [TOC] and mkdocs will parse all the # inside the file markdown starting with ## since the title of the markdown file is #; just a way to not to include the title in the table of contents.

It is a way to create TOC with jigsaw?

[mattstauffer]

Hey @diazgilberto,
There isn't right now, but that's a really clever idea.

It's certainly possible! But we don't have it as a feature yet.

[diazgilberto]

Another markdown notation that the current markdown parser doesn't do is special notes. When you do the following...

!!!note
    This is a special note.

!!!info
    This is a special info.

!!!warning
    This is a special warning.

!!!danger
    This is a special danger.

Some markdown parsers create a markup like this...

<note>
    <header>Note</header>
    <p>This is a special note.</p>
</note>
<br>
<info>
    <header>Info</header>
    <p>This is a special info.</p>
</info>
<br>
<warning>
    <header>Warning</header>
    <p>This is a special warning.</p>
</warning>
<br>
<danger>
    <header>Danger</header>
    <p>This is a special danger.</p>
</danger>

With a style that looks like this...

Since the current markdown parser doesn't do it, at my workplace we are using just html to credate the markup and added the tailwin css to make it happen.

I'm wondering if that is something you would like to pr.