# Galaxy markdown render preview - enhancement request

**URL:** <https://forum.ansible.com/t/galaxy-markdown-render-preview-enhancement-request/1701>\
**Category:** Project Discussions\
**Tags:** enhancement, galaxy-ng\
**Created:** [October 13, 2023, 3:17pm UTC](https://forum.ansible.com/t/galaxy-markdown-render-preview-enhancement-request/1701 "2023-10-13T15:17:58Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![utoddl](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/utoddl/32/249_2.png) [@utoddl](https://forum.ansible.com/u/utoddl)\
**Post date:** [October 13, 2023, 3:17pm UTC](https://forum.ansible.com/t/galaxy-markdown-render-preview-enhancement-request/1701/1 "2023-10-13T15:17:58Z")

</div>

Continuing the discussion from [Markdown features supported on galaxy.ansible.com](http://forum.ansible.com/t/markdown-features-supported-on-galaxy-ansible-com/1630/3):

I’d like to put this forward as a request for enhancement: to provide an API on galaxy to return the HTML that galaxy would render for a submitted blob of markdown. The discussion cited above, part of which is quoted below, shows how to use the equivalent API on both github and gitlab. Such a feature on galaxy would facilitate `README.md` and other `*.md` creation and editing by providing a mechanism for maintainers to see how their documentation renders before committing to publication.

> [@Markdown features supported on galaxy.ansible.com](http://forum.ansible.com/t/markdown-features-supported-on-galaxy-ansible-com/1630/3):
>
> I was hoping the new galaxy had something like github provides, where you can throw a block of markdown at its API and it throws back the rendered html. Here’s a bash function that uses it:
> 
> ```auto
> gfm2html ()
> { # github-flavored markdown to html. Requires jq.
> local fname=${1-README.md}
> if [! -f "$fname"]; then
> echo "'$fname' not found." 1>&2
> else
> jq --slurp --raw-input '{"text": "\(.)", "mode": "markdown"}' < "$fname" \
> | curl --data @- https://api.github.com/markdown
> fi
> }
> 
> ```

---

<div class="post-metadata">

**Author:** ![jlmitch5](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/jlmitch5/32/578_2.png) [@jlmitch5](https://forum.ansible.com/u/jlmitch5)\
**Post date:** [November 21, 2023, 3:18pm UTC](https://forum.ansible.com/t/galaxy-markdown-render-preview-enhancement-request/1701/2 "2023-11-21T15:18:21Z")

</div>

This sounds like a cool idea @utoddl, thanks for proposing!

We’ve got it added to our roadmap\* for scoping and inclusion in a future milestone. The team is a bit at capacity with our current shorter term roadmap of enhancements and fixes to galaxy right now. In short, we probably won’t be able to dedicate a dev to this feature until sometime next year at the earliest.

That being said, if you or anyone else is interested in working on this enhancement in the shorter term, we’d be happy to work through a potential PR for inclusion.

\*the roadmap mentioned/milestones are currently getting finalized we are hoping to publish info about these next week.

---

<div class="post-metadata">

**Author:** ![utoddl](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/utoddl/32/249_2.png) [@utoddl](https://forum.ansible.com/u/utoddl)\
**Post date:** [August 7, 2024, 9:10pm UTC](https://forum.ansible.com/t/galaxy-markdown-render-preview-enhancement-request/1701/3 "2024-08-07T21:10:50Z")

</div>

The [ansible/galaxy\_ng README.md](https://github.com/ansible/galaxy_ng#) invites me to [view the Roadmap](https://github.com/ansible/galaxy_ng/blob/master/ROADMAP.rst) which leads me to a three-year-old page leading to [roadmap for 4.4.0](https://issues.redhat.com/issues/?jql=project%20%3D%20AAH%20AND%20issuetype%20%3D%20Feature%20AND%20fixVersion%20%3D%204.4.0%20ORDER%20BY%20priority%20DESC) which is tweakable, but searching for various combinations of “markdown”, “preview”, and/or “galaxy” just … reminds me that I have a lot of “good intention” artifacts in my own projects.

I can throw no stones. [sigh]

---

<div class="post-metadata">

**Author:** ![bmclaughlin](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/bmclaughlin/32/573_2.png) [@bmclaughlin](https://forum.ansible.com/u/bmclaughlin)\
**Post date:** [August 12, 2024, 4:18pm UTC](https://forum.ansible.com/t/galaxy-markdown-render-preview-enhancement-request/1701/4 "2024-08-12T16:18:06Z")

</div>

Hi @utoddl! I actually took an interest in this one quite some time ago and [added a command](https://github.com/ansible/galaxy-importer/pull/254) to galaxy-importer to convert markdown to html. It was released with version 0.4.19 of galaxy-importer on January 18th.

---

<div class="post-metadata">

**Author:** ![utoddl](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/utoddl/32/249_2.png) [@utoddl](https://forum.ansible.com/u/utoddl)\
**Post date:** [August 12, 2024, 6:20pm UTC](https://forum.ansible.com/t/galaxy-markdown-render-preview-enhancement-request/1701/5 "2024-08-12T18:20:08Z")

</div>

Thank you, @bmclaughlin.

I’m a little vague on how `galaxy-importer` fits into the ecosystem. Is this the same code that’s used by [galaxy.ansible.com](http://galaxy.ansible.com) when uploading content? If so, does this imply that galaxy (the service) stores doc assets pre-rendered? (That would explain why I didn’t see anything relevant to rendering md→html when rummaging through the galaxy-ng code.)
