Source: https://mokxi.com/embed
Updated: 2026-10-05

Embeds

# Run Arduino and ESP32 sims in your tutorial

Paste one line and your readers get the circuit running in your post, with your own code: they press Run, read the sketch, and open a copy of their own. Free, and nobody needs an account to watch it run.

Build a circuit to embed See one running

## How to embed a circuit

Three steps, about a minute.

- Build it, or open one. Wire the circuit and write the sketch in the editor, then save it to your free account. Any of the built-in projects works too.
- Press Share, then Embed. Pick the size, the theme, whether the code shows and whether it starts on its own. The preview beside the options is the embed itself. Saving builds your sketch, so the embed runs your code, not a stand-in.
- Copy and paste. The iframe code goes in an HTML block; the Markdown goes in a README; the plain link goes anywhere that embeds by link.

## A live example

This is an embed, running on this page exactly as it would on yours. Press Run, switch to Code, open it in the editor.

The code for the embed above

Any built-in project can be embedded the same way, no account needed: /embed/example/<name>, with the name from the end of its page’s address on the projects page.

## The options

Add them to the embed’s address. The share sheet writes them for you; anything left out keeps its default.

Option | Values | What it does

theme | light, dark, auto | The colors. auto (the default) follows the reader’s system.

autorun | 1, 0 | 1 (the default) starts the circuit once it scrolls into view. 0 waits for Run, and downloads nothing until then.

view | circuit, code, split | What shows first. split puts the circuit and the code side by side, stacked on a phone.

height | 200 to 1200 | The height in pixels, for hosts that size the frame from the page.

hideCode | 1 | Takes the code out, the Code tab with it: the circuit alone.

start | a file name | The file the code opens on, such as notes.h.

edit | 0 | Hides the Edit in Mokxi link, which otherwise opens a copy of the circuit in the editor.

An address with options

## Where it works

Anywhere that takes an iframe, and a few places that take only a link.

Where | What to paste

WordPress | The iframe code, in a Custom HTML block.

GitHub Pages, Jekyll, Hugo, Astro, any static site | The iframe code, straight into the page or the Markdown file.

Medium, Ghost, Discourse | The project’s link (mokxi.com/p/...): it turns into the running circuit through oEmbed where the platform reads it.

Notion and other link embeds | The plain link.

A GitHub README | The Markdown: GitHub shows no frames, so it is the circuit’s picture, linking to the page where it runs.

Iframe

Markdown

Plain link

## Free, with a small badge

Embedding is free on every plan, with no limit on embeds or readers.

An embed from a free account carries a small “Made with Mokxi” link in the corner. A paid plan removes it. The embed sets no cookies and carries no advertising tags. See the plans.

Want the circuit to run in CI or from your own tools instead? That is the API and the CLI.
