Improving support for Markdown syntaxis in documentation entries.

[mmatera]

Adding support for markdown notation in figures and references. This would be helpful for a future migration to more standard documentation systems.

[rocky]

Personally, I think markdown at this stage is a bad idea. Sphinx works best with RsT. ad

Also, the regexps to handle this were kind of the wrong way to deal with documentation. Overall I'd like to reduce their use rather than increase their use and add more complexity here.

[mmatera]

Ok, I could add the rules for the RST syntax in another branch.

[mmatera]

Regarding the implementation, I see this as an intermediate step. This is why I tried to split the parts of the documentation system as much as possible.

The long term plan would be

• support the most suitable syntax for using an existing documentation library
• Progressively replace the old syntax by the new one.
• Once the documentation can be handled by a standard parser, remove the homebrew, regex based parser.