cleanup summery line docs

1. changes `# header` to `header`
2. changes `[link](url)` to:

```
[link]
... [link]: url
```

Fixes #16928
@huonw Yes, you are right. Thanks for clarification.