Recho Notebook

We want to live in the editor forever. — Luyu Cheng

Recho Notebook is a free, open-source, reactive editor for algorithms and ASCII art. It introduces a plain code format for notebooks — echoing output inline as comments for live, in-situ coding with instant feedback. Built on vanilla JavaScript and the reactive model of Observable Notebook Kit, Recho Notebook lets developers, artists, and learners explore algorithms and ASCII art interactively.

• Editor 📝 - The quickest way to get started with Recho Notebook.
• Announcement 📢 - Read our initial release story to discovery the vision behind Recho Notebook.
• Documentation 📚 - Learn how to use Recho Notebook with our comprehensive guides.
• Examples 🖼️ - See what you can create and draw some inspiration!
• Sharing 🎨 - Follow the instructions to open a pull request to share your sketches!
• Contributing 🙏 - We have a bunch of things that we would like you to help us build together!

Core Idea 🧠

Unlike typical notebooks (like Jupyter or Observable), Recho Notebook treats code and its output as a single, continuous document. When you write code, the output appears inline — as a comment right above your code.

If you modify the code, the echoed output updates immediately. So instead of switching between “code cells” and “output cells,” your entire notebook feels like a living text file that responds to you.

Design Philosophy 💡

The name Recho comes from “Reactive Echo” — every expression echoes its result, instantly. It’s meant to capture the feedback loop between code and creator — seeing how every small change ripples through your work.

Recho Notebook is both a tool and a statement — it imagines what happens if we strip away complex GUIs and treat code itself as the canvas.

It’s light, artistic, and reactive — blending ideas from creative coding, literate programming, and live performance.

Example Use Cases 🖼️

• Teaching/learning basic algorithms with immediate text/visual feedback.
• Creating text-based animations to experience the simplicity and clarity in ASCII art.
• Exploring code minimalism — finding beauty in code and its textual output.

Why Recho Notebook 🪶

We’ve always loved Observable Notebooks. To make notebooks more portable, we built Markdown Genji, extending Markdown with live code features. Later, Observable Framework and Observable Notebook Kit explored similar ideas, which made us wonder — could a notebook exist as a plain code file?

At the same time, we wanted to make coding more accessible and playful. Inspired by the p5.js web editor, we realized well-designed language doesn’t necessarily make coding more accessible — the environment does. So we asked — what if we focused on algorithms instead of graphics, using ASCII art when visuals are needed?

That’s how Recho Notebook began — a lighter way to code with creativity.

What's Next 🔥

Recho Notebook is in beta — and open source! 🎉 Try it out on our website or explore the code on GitHub. We’d love your thoughts, comments, or suggestions. Want to contribute? Here’s where you can help:

• Sharing Examples – text analysis, ASCII art, data viz, graphics, concrete poetry, or demos with D3, Tone, ml5… anything! One example is enough.
• Polyglot Programming – Recho Notebook is JavaScript-first but open to any language that compiles to JavaScript — Python, Rust, MLscript, wenyan‑lang… your playground.
• LLM Experiments – What if LLMs could "see" both the input and the output?

We’re also improving:

• Editing & Workflow – Reruns, formatting, smoother editing.
• Visuals – Dark theme, ANSI codes, more expressive output.
• Interactivity – Mouse, keyboard, and more input support.

Cloud storage is coming, but for now, keep it simple — and keep the ideas coming! 🚀

License 📄

ISC © Recho Notebook