I suggest you change this to use the `warning` sphinx directive - it's just like `note`, but shows it as a warning instead of a note.  E.g., 
```
.. warning::
    Make sure you understand the behaviour of the function that you
    are trying to invert! Depending on the cosmology, there may not be

...
```