# Tutorial Creators

**URL:** <https://forum.makecode.com/t/tutorial-creators/19464>\
**Category:** Educators' Lounge\
**Created:** [April 27, 2023, 6:23pm UTC](https://forum.makecode.com/t/tutorial-creators/19464 "2023-04-27T18:23:49Z")\
**Posts on this page:** 8\
**Page:** 5

<div class="post-metadata">

**Author:** ![MsBaschnagel](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/msbaschnagel/32/9377_2.png) [@MsBaschnagel](https://forum.makecode.com/u/MsBaschnagel)\
**Post date:** [January 22, 2025, 11:46pm UTC](https://forum.makecode.com/t/tutorial-creators/19464/81 "2025-01-22T23:46:49Z")

</div>

Oh, that is awesome. Thank you so much.

---

<div class="post-metadata">

**Author:** ![rymc88](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/rymc88/32/13577_2.png) [@rymc88](https://forum.makecode.com/u/rymc88)\
**Post date:** [April 23, 2025, 9:36pm UTC](https://forum.makecode.com/t/tutorial-creators/19464/82 "2025-04-23T21:36:11Z")

</div>

Created a simple doc as a cheat sheet for the Tutorial Maker with images to give people some visuals of what the markdown do. Please let me if I am missing anything and I will try my best to keep this up-to-date

[Tutorial Maker Cheat Sheet](https://docs.google.com/document/d/1w_P2rgd6kZJUnrr69lP0QTnYviiLV4gmPduIOUCvEjk/edit?usp=sharing)

---

<div class="post-metadata">

**Author:** ![KIKIvsIT](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/kikivsit/32/10492_2.png) [@KIKIvsIT](https://forum.makecode.com/u/KIKIvsIT)\
**Post date:** [May 2, 2025, 5:54pm UTC](https://forum.makecode.com/t/tutorial-creators/19464/83 "2025-05-02T17:54:55Z")

</div>

Oh, wow! That’s super cool! Would you mind if I build off of this for my Tutorial Tutorial?

---

<div class="post-metadata">

**Author:** ![rymc88](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/rymc88/32/13577_2.png) [@rymc88](https://forum.makecode.com/u/rymc88)\
**Post date:** [May 3, 2025, 7:28pm UTC](https://forum.makecode.com/t/tutorial-creators/19464/84 "2025-05-03T19:28:15Z")

</div>

Not at all, please use it. I plan on adding to it to show how to connect it to github for uploading images/gifs/videos and creating skill maps for educators.

---

<div class="post-metadata">

**Author:** ![brianM1](https://avatars.discourse-cdn.com/v4/letter/b/858c86/32.png) [@brianM1](https://forum.makecode.com/u/brianM1)\
**Post date:** [August 15, 2025, 4:21pm UTC](https://forum.makecode.com/t/tutorial-creators/19464/85 "2025-08-15T16:21:05Z")

</div>

This is great, thanks for sharing. Does anyone have any guidance for making blocks in extensions work? I’m building tutorials for microbit makecode and want to use some extensions. I tried the packages code suggested here: [https://makecode.com/writing-docs/snippets#package](https://makecode.com/writing-docs/snippets#package) but that did not work. I may have done it wrong. Any guidance or suggestions would be appreciated.

---

<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:** [August 15, 2025, 4:22pm UTC](https://forum.makecode.com/t/tutorial-creators/19464/86 "2025-08-15T16:22:13Z")

</div>

That is the format to use; e.g. one of our built in examples loading a repo: [https://github.com/microsoft/pxt-microbit/blob/63df3029a60b8cb11576b3caeb0c9eb390c1b91d/docs/projects/turtle-spiral.md?plain=1#L31](https://github.com/microsoft/pxt-microbit/blob/63df3029a60b8cb11576b3caeb0c9eb390c1b91d/docs/projects/turtle-spiral.md?plain=1#L31) or a built in package [pxt-microbit/docs/reference/radio/packet.md at 63df3029a60b8cb11576b3caeb0c9eb390c1b91d · microsoft/pxt-microbit](https://github.com/microsoft/pxt-microbit/blob/63df3029a60b8cb11576b3caeb0c9eb390c1b91d/docs/reference/radio/packet.md?plain=1#L55) – if you can share the tutorial you’re trying we can figure out what’s missing

---

<div class="post-metadata">

**Author:** ![brianM1](https://avatars.discourse-cdn.com/v4/letter/b/858c86/32.png) [@brianM1](https://forum.makecode.com/u/brianM1)\
**Post date:** [August 15, 2025, 9:16pm UTC](https://forum.makecode.com/t/tutorial-creators/19464/87 "2025-08-15T21:16:51Z")

</div>

Thanks for the examples. I’m doing something wrong. Here is the result: [https://bmoran23.github.io/microbittutorialnoisesense/noiseTutorial](https://bmoran23.github.io/microbittutorialnoisesense/noiseTutorial)

See how the extension blocks are grey and just show text.

And here is the markdown: [https://github.com/bmoran23/microbittutorialnoisesense/blob/master/noiseTutorial.md?plain=1](https://github.com/bmoran23/microbittutorialnoisesense/blob/master/noiseTutorial.md?plain=1)

Any idea what I’m doing wrong?

---

<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:** [August 15, 2025, 9:27pm UTC](https://forum.makecode.com/t/tutorial-creators/19464/88 "2025-08-15T21:27:11Z")

</div>

hm, plugging in the text to the tutorial tool does work, which leaves me to think it’s an with the other files in the extension – for tutorials loaded from github they get added as a normal extension, so the pxt.json imports / main.ts also apply. When i load that tutorial from github into a project, it ends up as [https://makecode.microbit.org/\_HXLV6vPdpK8K](https://makecode.microbit.org/_HXLV6vPdpK8K), which is pegged to 0.0.1 released 2 days ago

 ![image](https://us1.discourse-cdn.com/flex020/uploads/makecode/original/3X/7/d/7d38b587e75d1deebfbac54b64c13689eaddade0.png)

Releasing a new version should work (but also check to confirm that e.g. you want the code that currently exists in main.ts)

[Previous page](https://forum.makecode.com/t/tutorial-creators/19464.md?page=4)
