Writing documentation
*******************************************

.. toctree:: 
   :maxdepth: 2
   :hidden: 
   
   AboutSphinx
   UsingReStructuredText.rst
   UsingReStructuredText_Tables.rst
   Using_SQLTable.md
   Using_SourceCode.md
   UsingReStructuredText_MermaidDiagrams.rst
   Using_MathEquations.md
   Using_Footnotes.md
   Using_Citations.md
   Using_BibTeXCitations.md
   UsingMarkdown.md
   UsingMarkdown_InternalLinks.md

This section covers the following topics:

* How to write the documentation using reStructuredText_.
* How to write the documentation using Markdown_.

It also works as a quick reference in case you don't remember something.

.. warning::

   Most of the examples here are in reStructuredText. 
   Simply because those examples were already available.
   We will probably use Markdown more and more... or mix the two if we need. 
   Anyway. We'll try to create examples in both notations.


.. links-placeholder

.. include:: ../_sharedFiles/Links.rst