MakeCode Tutorial Editor: Help with showing all coding blocks from the start

Educators' Lounge
1

Hello All,

I’m creating a tutorial, and I want to use the hint blocks, but I want the hit blocks to show for that level, not the entire lesson. Is there a way to make it so on certain steps you have all the coding blocks and on others only certain ones?

Also can you including short videos instead of just image and gifs?

2

First part: Not so sure.

Second part: I recall being able to put youtube videos in tutorials as one about a carnival had one. So yes… Probably.

3

Take a look at this one for reference. Feel free to copy-and-paste the code into the tutorial tool.

https://raw.githubusercontent.com/Microsoft/pxt-microbit/refs/heads/master/docs/projects/flashing-heart.md

Specifically, look at Step 2:

## {Step 2}

Drag another ``||basic:show leds||`` block underneath the first.

```blocks
basic.forever(function() {
    basic.showLeds(`
        . # . # .
        # # # # #
        # # # # #
        . # # # .
        . . # . .`);
    basic.showLeds(`
        . . . . .
        . . . . .
        . . . . .
        . . . . .
        . . . . .`);
})
```

This group of blocks will only appear in the hint in step 2. It will not appear elsewhere.

If I’m misinterpreting your question, then feel free to provide an example of what you’re trying to do. (A link to your current tutorial would be helpful in that case.)

As for videos, you can embed YouTube videos as demonstrated in the first tutorial from Whack the Mole.

## Whack-the-Mole Intro @showdialog

![whack-the-mole](youtube:UKYPIXl7agI)

---

Special thanks to MakeCode forum User _SoftTalker_ for this submission.

Otherwise, you could include a URL to the video.

5

I do not believe that is possible. You can configure a tutorial to show just the blocks used in the tutorial, or it can show the entire toolbox. You cannot show different “versions” of the toolbox in each step.

6

Okay that makes sense. I had thought you could change or as the student goes through more levels the toolbox opens up more before somewhere.

7

How do you get the emojis to work? I saw in some tutorials they would use them, and the markup code is for example :suitcase: but they do not load.

8

Another question, can I make custom functions that can be preloaded into the tutorial Toolbox? Some of the heavier math, I would rather it be in a function and students can just bring that out, like a custom library.

9

@Winess yes! you can either create your own extension in a github repo and reference it like this in your tutorial markdown:

```package
extension-name=github:github-username/extension-name
```

or you can inline the extension in your markdown file like this:

```customts
//% weight=100 color=#0fbc11 icon=""
namespace custom {
    //% block
    export function foo(n: number, s: string): void {
        // Add code here
    }
}
```
1 Like
10

Thank you, I have been referencing the tutorial guide. How do you get the emojis to work? I saw in some tutorials they would use them, and the markup code is for example :suitcase: but they do not load.

11

@Winess try embedding the emoji directly in the markdown instead of using the :whatever: syntax

12

Thank you, the UTF-8 Unicode inserting does work, for example :mount_fuji:

Another question: can students only do the block coding when making Arcade MakeCode Tutorials in the Tutorial Editor? The box in the middle that allows you to choose your programming language dissapears when using the share link.

13

When writing tutorials, you set which languages are used.