Can we have subsections in Examples?

For a docstrings with several examples, it would be nice to be able to clearly separate them:

Examples
-------------

Here we show two examples of our awesome function.

First example
~~~~~~~~~~

foo

Second example
~~~~~~~~~~~~~

bar

Just tried it and it seems to break the doc build:

/home/br/repos/scipy/scipy/doc/source/reference/generated/scipy.interpolate.RegularGridInterpolator.rst:33: CRITICAL: Unexpected section title.

Interpolation and extrapolation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [  2%] reference/generated/scipy.interpolate.Akima1DInterpolator.__calwriting output... [  3%] 

<snip>

dumping object inventory... done
build finished with problems, 1 warning.
make: *** [Makefile:118: html-scipyorg] Error 1

To illustrate the origin: note the As a second example, we... transition in
http://scipy.github.io/devdocs/reference/generated/scipy.interpolate.RegularGridInterpolator.html#scipy.interpolate.RegularGridInterpolator

Not sure if it's even that good of an idea, or how difficult it is to implement.

Start with the generated documentation example at scipy.interpolate.RegularGridInterpolator.rst and reproduce the documented Sphinx build failure shown in the issue. Trace how numpydoc handles multiple Examples sections and determine whether subsection titles can be supported; done means the example builds without the Unexpected section title error and the intended subsections render clearly.