Leverage more markdown where we can

[richsalz]

The Tao is turned from markdown into HTML by the wagtail plugin. We should leverage more of its (limited?) capabilities in the document, such as

• Markdown links not a and href tags
• Auto-numbering of the table of contents and items
• Better URL referencing, the [foo](https://foo...) or the equivalent that is supported, if anything.

[richsalz]

Please re-open this, and assign it to @ghwood . I fixed the stuff I could, now it's up to him and wagtail knowledge :)

[larseggert]

Specifically:

• links should use Markdown syntax (and not <a href>)
• tables should use Markdown (and not HTML)

Also, the CI should validate that the Markdown or at least the final HTML are correct - just glancing at the Markdown at the moment I see several things that are clearly broken (<a href="#2-2-4"/>mentioned above</a>, <a href="#https://www.rfc-editor.org/info/bcp97">, etc.)

[richsalz]

@ghwood there are dozens of things like

<a href-"#http.....

Looks like a find/replace went haywire?

[ghwood]

Apologies: that's a broken pattern I introduced and my (clearly insufficient) checks did not catch. I agree about doing a better job of validation going forward. I've submitted a PR to fix this specific issue as a quick fix.

I'll submit further PRs to markdown-ify the external links and tables.