Thibaud Colas thibaudcolas

Publish page via Wagtail v3 API

Session ID: ses_fc6f8a401ffevjq5KY1gdZo9FE Created: 8/25/2026, 2:06:18 PM Updated: 8/25/2026, 2:41:37 PM

User

Markdown Importer Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Add a dependency-free Markdown-to-ContentState importer to draftjs_exporter, with a two-phase parse-then-filter architecture.

Architecture: MarkdownImporter wires together MarkdownParser (CommonMark core → valid ContentState) and ContentStateFilter (declarative rules → filtered ContentState). Entity creation for links/images goes through configurable resolver chains; a shipped scheme_resolver helper handles internal-URL syntaxes like wagtail://image?id=10. A configurable inline_html_styles whitelist maps paired HTML tags (<sup>) to inline styles. Spec: docs/superpowers/specs/2025-07-21-markdown-importer-design.md.

Tech Stack: Python 3.10+ stdlib only (re, urllib.parse), pytest + unittest-style test classes,

Markdown Importer — Design Spec

Overview

Add a Markdown-to-ContentState importer to draftjs_exporter, complementing the existing ContentState-to-HTML/Markdown exporter. The design follows a two-phase architecture: parsing (Markdown text → valid ContentState) then filtering (ContentState → ContentState with content policy applied). A public MarkdownImporter class wires them together with a config shape that mirrors the exporter's pattern.

Overview template

Website

One-line positioning

Triage: JPEG XL image support

Assessed against selection criteria + product strategy v1.0 on 2026-07-07.

🏔️ JPEG XL image support

Add JPEG XL (JXL) encoding/decoding to Willow, then expose the format in Wagtail core for image uploads and renditions, enabling ~15% smaller file sizes than AVIF, reducing bandwidth and carbon footprint with minimal user effort.

Classification: Pillar work

	<!DOCTYPE html>
	<html lang="en">
	<head>
	<meta charset="UTF-8">
	<meta name="viewport" content="width=device-width, initial-scale=1.0">
	<title>wagtail - Agent Session</title>
	<style>
	:root {
	--bg-primary: #f7f7fa;
	--bg-surface: #ffffff;

	<!DOCTYPE html>
	<html lang="en">
	<head>
	<meta charset="UTF-8">
	<meta name="viewport" content="width=device-width, initial-scale=1.0">
	<title>two_wagtail - Agent Session</title>
	<style>
	:root {
	--bg-primary: #f7f7fa;
	--bg-surface: #ffffff;

	<!DOCTYPE html>
	<html lang="en">
	<head>
	<meta charset="UTF-8">
	<meta name="viewport" content="width=device-width, initial-scale=1.0">
	<title>guide - Agent Session</title>
	<style>
	:root {
	--bg-primary: #f7f7fa;
	--bg-surface: #ffffff;

	<!DOCTYPE html>
	<html lang="en">
	<head>
	<meta charset="utf-8">
	<meta name="viewport" content="width=device-width, initial-scale=1">
	<title>Machine Translation Model Evaluation Report</title>
	<style>
	:root {
	--bg: #f6f7f9;
	--card: #ffffff;