WeAreDevelopers Logo WeAreDevelopers
Sign in
For You LIVE
World Congress 2026 Europe - Virtual Stage • Jul 2, 2026 • Session details

Why Is Software Documentation Still Static – And Why Modern Browsers Deserve Better

André Dietrich , Jihad Hyadi

Why force developers to leave your documentation to test code? Reimagining Markdown as an interactive environment lets users execute, edit, and iterate natively within their browser.

Pause
Mute Enter Fullscreen
#1 about 2 min

Setting up a live Markdown preview environment

Preparing a live demonstration of interactive Markdown documentation using GitHub and LiaScript.

#2 about 2 min

Why AI prefers HTML but developers need Markdown

The trade-offs between the rich interactivity of HTML generated by AI and the human readability of Markdown.

#3 about 2 min

Breaking the static documentation publishing loop

How traditional static site generation forces developers into a disjointed process of reading, copying, and local debugging.

#4 about 2 min

Analyzing boilerplate in TensorFlow JavaScript examples

Exploring how the scattered structure and heavy HTML boilerplate of TensorFlow JS documentation hinders learning.

#5 about 2 min

Shifting to a mental model of interactive Markdown

Empowering Markdown with native browser capabilities to eliminate static publishing steps and enable in-place execution.

#6 about 3 min

Executing JavaScript directly within a Markdown document

Embedding and running basic TensorFlow JavaScript code blocks inside a live Markdown editor.

#7 about 2 min

Managing console outputs and asynchronous function execution

Adapting the execution environment to capture console logs and handle asynchronous training loops without blocking.

#8 about 4 min

Rendering visual data with web components and Chart.js

Integrating external visualization libraries into Markdown to display training data dynamically without leaving the document.

#9 about 2 min

Reducing repetitive code with Markdown macros

Defining text substitution macros to hide boilerplate and create importable, interactive documentation libraries.

#10 about 3 min

Making dynamic elements first-class Markdown citizens

Embedding standalone script tags and browser internationalization features to build dynamic and localized tutorials.

#11 about 4 min

Binding data across responsive Markdown script inputs

Utilizing interactive sliders and asynchronous data fetching to automatically recalculate and update outputs across a document.

#12 about 4 min

Enhancing tutorials with animations and text-to-speech

Adding step-by-step code reveals and browser-based audio narration to support accessible, presentation-style learning.

#13 about 3 min

Publishing decentralized interactive open educational resources

Leveraging LiaScript and Git repositories to host free, extensible, and interactive courses without managing dedicated servers.

Matching moments

2:43 min

Creating interactive educational content with LiaScript

André Dietrich André Dietrich · WWC 2024

3:05 min

Audience Q&A on AI documentation formatting and tools

Edvin Teskeredzic Edvin Teskeredzic · WWC Europe 2026

6:40 min

Powering interactive JavaScript learning environments in the browser

Chris Heilmann +2 · LIVE

8:29 min

Scripting interactive technical presentations inside the editor environment

Chris Heilmann +9 · LIVE

1:05 min

Presentation design and open source markdown tools

Chris Nesbitt-Smith · LIVE

51 sec

Generating static web content with Markdown and Liquid templates

Chris Heilmann +2 · LIVE

More from World Congress 2026 Europe - Virtual Stage

One Does Not Simply Make Architecture Decisions Alone thumbnail
36:15
29 days ago

One Does Not Simply Make Architecture Decisions Alone

Vladas Diržys

From Black Box to Glass Box : Bedrock AgentCore Observability thumbnail
21:15
about 1 month ago

From Black Box to Glass Box : Bedrock AgentCore Observability

Yasemin Aktürk

Leading in Rhythm: How Women Make Better Decisions with Biological Intelligence thumbnail
30:41
about 1 month ago

Leading in Rhythm: How Women Make Better Decisions with Biological Intelligence

Julia Grosse

Better Together: Leveraging Your Observability Tools as a SIEM thumbnail
39:06
about 1 month ago

Better Together: Leveraging Your Observability Tools as a SIEM

Mathias Palmersheim

ChatGPT Apps: From Chat to Checkout thumbnail
30:29
about 1 month ago

ChatGPT Apps: From Chat to Checkout

Aaron Koivunen

Interior Decorating (TypeScript Decorators) thumbnail
29:22
about 1 month ago

Interior Decorating (TypeScript Decorators)

Michael Dowden

Upcoming sessions on this topic

Open session

World Congress 2026 North America

When Humans Stop Writing Code: Rethinking Languages, Compilers, and Responsibility

Simon Auer

Organizer of flutter vienna meetup and CEO of marqably

Simon Auer
Open session

World Congress 2026 North America

Small LLM in your Browser: Huge Opportunities for Web Applications

Daniel Ostrovsky

UI/UX Architect at Payoneer | AI Architect | Full Cycle Development Expert | Public Speaker | Open Source Contributor |

Daniel Ostrovsky
Open session

World Congress 2026 North America

Vibe Coding Accessibility

Karl Groves

Focused on actively fixing accessibility

Karl Groves
Open session

World Congress 2026 North America

Beyond Vibe Coding: Using CLI Tools as Your AI Counterpart in Pair Programming

Ron Veen

Java enthusiast and Special agent for Team Rockstars IT

Ron Veen
Open session

World Congress 2026 North America

Architecting AI in Angular: WebMCP, A2UI, and the Agent Experience

Ankita Sood

Sr. Principal Engineer @ Secureworks | Angular GDE

Ankita Sood
Open session

World Congress 2026 North America

From Software Agents to Physical Devices: Inside the Agentic Hardware Stack

Vivian Hu, Michael Yuan

Vivian Hu
Michael Yuan

Related videos

WeAreDevelopers LIVE - 11ty and a11y thumbnail
1:05:26
LIVE • 5 months ago

WeAreDevelopers LIVE - 11ty and a11y

Chris Heilmann, Daniel Cranney, Kitty Giraudel

Transforming Education: A Journey from interactive Markdown to Remote-Labs thumbnail
30:03
WWC 2024 • almost 2 years ago

Transforming Education: A Journey from interactive Markdown to Remote-Labs

André Dietrich

WeAreDevelopers LIVE – Keeping Up with Styles, Data & More thumbnail
1:16:52
LIVE • 6 months ago

WeAreDevelopers LIVE – Keeping Up with Styles, Data & More

Chris Heilmann, Daniel Cranney, Peter Kröner

WeAreDevelopers LIVE - Streaming HTML thumbnail
1:10:26
LIVE • 13 days ago

WeAreDevelopers LIVE - Streaming HTML

Chris Heilmann, Daniel Cranney, Jad Joubran

Making Documentation AI-Ready: Preparing Your Docs for the LLM Era thumbnail
27:16
WWC Europe 2026 • about 1 month ago

Making Documentation AI-Ready: Preparing Your Docs for the LLM Era

Edvin Teskeredzic

WeAreDevelopers LIVE - CSS or BS? thumbnail
52:59
LIVE • 4 months ago

WeAreDevelopers LIVE - CSS or BS?

Chris Heilmann, Daniel Cranney, Keith Cirkel

Related articles

From learning to earning

Jobs that call for the skills explored in this talk.