# Sharing Markdown Documentation

**URL:** <https://forum.makecode.com/t/sharing-markdown-documentation/24594>\
**Category:** PXT\
**Tags:** extension\
**Created:** [November 28, 2023, 6:20pm UTC](https://forum.makecode.com/t/sharing-markdown-documentation/24594 "2023-11-28T18:20:36Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![GrandpaBond](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/grandpabond/32/10835_2.png) [@GrandpaBond](https://forum.makecode.com/u/GrandpaBond)\
**Post date:** [November 28, 2023, 6:20pm UTC](https://forum.makecode.com/t/sharing-markdown-documentation/24594/1 "2023-11-28T18:20:36Z")

</div>

Is there a way to share as an HTML a fully-rendered README.md for a fledgling extension?

---

<div class="post-metadata">

**Author:** ![jwunderl](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/jwunderl/32/5308_2.png) [@jwunderl](https://forum.makecode.com/u/jwunderl)\
**Post date:** [November 28, 2023, 6:28pm UTC](https://forum.makecode.com/t/sharing-markdown-documentation/24594/2 "2023-11-28T18:28:31Z")

</div>

If you’re using the github integration to create the extension, then depending on the editor it may be generating a github pages site for you; e.g. for [https://github.com/jwunderl/ignore-me-testing-2](https://github.com/jwunderl/ignore-me-testing-2), the uninteresting (/ broken because I made that extension while halfway through implementing other things) page for it is [https://jwunderl.github.io/ignore-me-testing-2/](https://jwunderl.github.io/ignore-me-testing-2/), and [https://jwunderl.github.io/ignore-me-testing-2/README](https://jwunderl.github.io/ignore-me-testing-2/README) is generated from the README.md

there’s also an `/pkg/{repo-slug}` route that will read from your extensions README.md; e.g. [https://arcade.makecode.com/pkg/jwunderl/pxt-status-bar](https://arcade.makecode.com/pkg/jwunderl/pxt-status-bar) from [https://github.com/jwunderl/pxt-status-bar](https://github.com/jwunderl/pxt-status-bar) in arcade, though that one is only available for approved if I recall correctly.

---

<div class="post-metadata">

**Author:** ![GrandpaBond](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/grandpabond/32/10835_2.png) [@GrandpaBond](https://forum.makecode.com/u/GrandpaBond)\
**Post date:** [November 28, 2023, 11:59pm UTC](https://forum.makecode.com/t/sharing-markdown-documentation/24594/3 "2023-11-28T23:59:36Z")

</div>

I’ve just learned from Martin Williams (of the Micro:bit Educational Foundation) that one technique is to click on the README pull-out preview panel; Select All; then Print… to “Save as PDF”. Worked for me.