# Coexisting Markdown and RST documentation

**URL:** <https://discourse.julialang.org/t/coexisting-markdown-and-rst-documentation/29161>\
**Category:** General Usage\
**Tags:** documentation\
**Created:** [September 25, 2019, 1:40pm UTC](https://discourse.julialang.org/t/coexisting-markdown-and-rst-documentation/29161 "2019-09-25T13:40:37Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![heliosdrm](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/heliosdrm/32/3851_2.png) [@heliosdrm](https://discourse.julialang.org/u/heliosdrm)\
**Post date:** [September 25, 2019, 1:40pm UTC](https://discourse.julialang.org/t/coexisting-markdown-and-rst-documentation/29161/1 "2019-09-25T13:40:37Z")

</div>

Julia docstrings are expected to be written in Markdown, but there are situations where it it may be useful to use other formats. E.g. the package [GR](https://github.com/jheinen.GR.jl) is part of a larger project whose documentation seems to be made with Sphinx, using sources written in RST (cf. [https://gr-framework.org](https://gr-framework.org/)). The documentation of GR’s high-level functions in Julia ([jlgr Reference — GR Framework 0.66.0 documentation](https://gr-framework.org/julia-jlgr.html)) uses the docstrings given in the source code, which are also written in RST to be consistent with the rest of the documentation.

As I commented some days ago, I am working on [GRUtils](https://github.com/heliosdrm/GRUtils.jl), a package based on a module of GR to make it more “Julian”, and I wonder what should I do with the docstrings. One the one hand side I would like it to have docstrings that are nicely parsed by the tools provided by Julia (e.g. Documenter.jl), and this means rewriting them as Markdown. On the other hand, I would like to facilitate the production of documentation sources based on RST - as those of the original GR package -, with the same docstrings.

Is it possible to have both things? How can this be made?