cleanup summery line docs

1. changes `# header` to `header`
2. changes `[link](url)` to:

```
[link]
... [link]: url
```

Fixes #16928
The current look-and-feel of the headings on the index pages is about what we would want, so I don't think we should compromise the headings.