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 · World Congress 2024

3:05 min

Audience Q&A on AI documentation formatting and tools

Edvin Teskeredzic Edvin Teskeredzic · World Congress 2026 Europe

6:40 min

Powering interactive JavaScript learning environments in the browser

Chris Heilmann Chris Heilmann +2 · LIVE

8:29 min

Scripting interactive technical presentations inside the editor environment

Chris Heilmann 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 Chris Heilmann +2 · LIVE

More from World Congress 2026 Europe - Virtual Stage

One Does Not Simply Make Architecture Decisions Alone thumbnail
36:15
2 months ago

One Does Not Simply Make Architecture Decisions Alone

Vladas Diržys

From Black Box to Glass Box : Bedrock AgentCore Observability thumbnail
21:15
3 months 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
3 months 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
3 months ago

Better Together: Leveraging Your Observability Tools as a SIEM

Mathias Palmersheim

ChatGPT Apps: From Chat to Checkout thumbnail
30:29
3 months ago

ChatGPT Apps: From Chat to Checkout

Aaron Koivunen

Interior Decorating (TypeScript Decorators) thumbnail
29:22
3 months ago

Interior Decorating (TypeScript Decorators)

Michael Dowden

Related videos

WeAreDevelopers LIVE - 11ty and a11y thumbnail
1:05:26
LIVE • 7 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
World Congress 2024 • about 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 • 8 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 • about 2 months 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
World Congress 2026 Europe • 3 months ago

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

Edvin Teskeredzic

WeAreDevelopers LIVE - CSS or BS? thumbnail
52:59
LIVE • 5 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.