cleanup summery line docs

1. changes `# header` to `header`
2. changes `[link](url)` to:

```
[link]
... [link]: url
```

Fixes #16928
Why is the `#` heading removed?