Beginners' FAQ in the Wiki

[peterhinch]

The Micropython Wiki is an underused resource. I've made a start on a FAQ for people new to MP. Contributions are encouraged.

One oddity is that headings are rendered in blue so look like links. I've written a lot of markdown on Git and never come across this before. Does anyone know how to fix it?

[andrewleech]

Thanks @peterhinch I've really wanted to get more up there too, I applaud your efforts and yes I think we should all add stuff there!

The headings colour does stand out, yeah. They are "links" in the sense they have anchors that can be used as shortcuts and shared as links, but most other markdown renderers don't colour them as such. I can't see any suggestion of this being configurable at all, don't know if it can be changed at all.

[peterhinch]

Oddly other markdown docs on GitHub don't have this behaviour (bug?). It is possible to create links to normal headings, as in a TOC.

[Josverl]

One oddity is that headings are rendered in blue so look like links. I've written a lot of markdown on Git and never come across this before. Does anyone know how to fix it?

Well, they are links, any reason to disable that?

[peterhinch]

That's odd: they are rendered in black this morning. It now looks and behaves like other Markdown on Git. I've no idea what changed overnight.

[Josverl]

Just noticed this popping up :

links to: https://github.com/settings/accessibility

[peterhinch]

Thanks for that.

The behaviour of headings is still odd. Sometimes they are rendered in blue, sometimes in black. Yet the headings in other md docs are always black. It seems weird that the Wiki should be different. But it's hardly a showstopper :)