Make doc styler detect lists on rst and better support for Windows
# What does this PR do?

The new lines for the lists in rst files were not actually added because I made a mistake, this PR fixes that. @patrickvonplaten it adds some new lines in the benchmarking files which I think are okay, but let me know if I should write some special code to get the scripts to ignore them.

Also, changed the line that added the new lines before doc special words since it seems to be not working properly on Windows. Let's see if this version is better!

(Failures are because master is red at the time of this PR.)

Fixes #9438