cleanup summery line docs

1. changes `# header` to `header`
2. changes `[link](url)` to:

```
[link]
... [link]: url
```

Fixes #16928
This is not correct, it is a citation, not a link. (The link "URL" is a nonsense URL.)