# Good ressources for writing tutorials

**URL:** <https://forum.makecode.com/t/good-ressources-for-writing-tutorials/44721>\
**Category:** micro:bit extensions\
**Tags:** tutorial\
**Created:** [June 29, 2026, 6:49pm UTC](https://forum.makecode.com/t/good-ressources-for-writing-tutorials/44721 "2026-06-29T18:49:24Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![PasAlt](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/pasalt/32/33199_2.png) [@PasAlt](https://forum.makecode.com/u/PasAlt)\
**Post date:** [June 29, 2026, 6:49pm UTC](https://forum.makecode.com/t/good-ressources-for-writing-tutorials/44721/1 "2026-06-29T18:49:25Z")

</div>

Hi everyone! My name is Pascal. I recently started to extend the existing NeoPixels extension ([https://github.com/PasAlt/pxt-neopixel-matrix-extension](https://github.com/PasAlt/pxt-neopixel-matrix-extension)). I’m now trying to write some tutorials for it ([https://github.com/PasAlt/neopixel-tutorial](https://github.com/PasAlt/neopixel-tutorial)).

I’m trying to get a hold on how to write good Tutorials and I stumpled upon the following repo on github: [https://github.com/microsoft/pxt-tutorial-sample](https://github.com/microsoft/pxt-tutorial-sample) . Unfortunately those parts seem to be abandoned and, at least for me, it won’t start anymore.

Then I tried to get myself an overview here: [https://makecode.com/writing-docs/tutorials/basics](https://makecode.com/writing-docs/tutorials/basics) but I found it not that helpful. On my browser this renders weirdly.

Does any one else have a better and complete ressource on how to write tutorials for MakeCode?

---

<div class="post-metadata">

**Author:** ![1978monkeynutze](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/1978monkeynutze/32/33979_2.png) [@1978monkeynutze](https://forum.makecode.com/u/1978monkeynutze)\
**Post date:** [June 30, 2026, 2:22am UTC](https://forum.makecode.com/t/good-ressources-for-writing-tutorials/44721/2 "2026-06-30T02:22:34Z")

</div>

welcome to the forums @PasAlt

---

<div class="post-metadata">

**Author:** ![AlexK](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/alexk/32/33339_2.png) [@AlexK](https://forum.makecode.com/u/AlexK)\
**Post date:** [June 30, 2026, 2:37am UTC](https://forum.makecode.com/t/good-ressources-for-writing-tutorials/44721/3 "2026-06-30T02:37:02Z")

</div>

Welcome, Pascal! The main documentation page for writing tutorials is found here:

> **[Tutorials](https://makecode.com/writing-docs/tutorials)**
>
> Step by step tutorials are authored in markdown and automatically converted by the editor. This page describes the format for these tutorials.

Take advantage of the tutorial tool if you haven’t done so already.

[https://makecode.com/tutorial-tool](https://makecode.com/tutorial-tool)

The best way to learn how to write tutorials, though, is to view the code for the existing tutorials. Find a tutorial from the MakeCode for micro:bit home page, and then look over the code for the syntax.

> **[pxt-microbit/docs at master · microsoft/pxt-microbit](https://github.com/microsoft/pxt-microbit/tree/master/docs)**
>
> master/docs

I’ve started writing a “tutorial on tutorials.” It’s incomplete, but it has some information on the planning process.

> **[MakeCode instructions and ramblings](https://robo-technical-group.github.io/pxt-instructions-lab/)**
>
> MakeCode instructions and ramblings laboratory

Also, I have to plug our friend Ryan’s session that he gave at last year’s ArcadeCon!

[![](https://img.youtube.com/vi/luA6NISE3rk/maxresdefault.jpg "Hands On with Arcade Tutorials (Arcade-Con 2025)") ](https://www.youtube.com/watch?v=luA6NISE3rk)

Please be sure to ask questions! There are several of us here who write skillmaps and tutorials. We’ll be happy to help.

---

<div class="post-metadata">

**Author:** ![PasAlt](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/pasalt/32/33199_2.png) [@PasAlt](https://forum.makecode.com/u/PasAlt)\
**Post date:** [June 30, 2026, 5:12pm UTC](https://forum.makecode.com/t/good-ressources-for-writing-tutorials/44721/4 "2026-06-30T17:12:35Z")

</div>

Thanks everyone for that warm welcome!

Thanks for those plentyful ressources! I missed that there is a top page for tutorials and another one for writing docs in general: [https://makecode.com/writing-docs](https://makecode.com/writing-docs). I was especially looking for the Macros option which is only linked in the top page about writing docs.

---

<div class="post-metadata">

**Author:** ![AlexTheGoober64](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.makecode.com/alexthegoober64/32/35807_2.png) [@AlexTheGoober64](https://forum.makecode.com/u/AlexTheGoober64)\
**Post date:** [June 30, 2026, 5:22pm UTC](https://forum.makecode.com/t/good-ressources-for-writing-tutorials/44721/5 "2026-06-30T17:22:52Z")

</div>

hello fellow coder, welcome to the forms