Thibaud Colas thibaudcolas

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

Django Documentation Token Report

Total Documents: 656

Total Tokens: 10,801,338

LLMs.txt Files

File	Tokens

Evaluating Markdown support in LLMs

With explicit prompting for Markdown output (best case scenario).

Problem scenarios

Strikethrough

~ vs. ~~, inconsistent between models.

Skill session log - upgrading-stylelint, OpenCode Kimi K2.5, django-pattern-library

Pull request: django-pattern-library#275

Discussion: Feedback needed: agent skill for Stylelint upgrades #49

Package quadrants diagram

quadrantChart
    x-axis Low downloads --> High downloads
    y-axis Low stars --> High stars

    quadrant-1 "Popular"
    quadrant-2 "High visibility"
 quadrant-3 "Under the radar"

name	upgrade-wagtail
description	Plan and optionally execute an upgrade to a new Wagtail release, including all needed dependency updates.
license	MIT

Upgrade Wagtail

Usage:

	#!/usr/bin/env -S uv run
	# /// script
	# dependencies = [
	# "python-frontmatter>=1.0",
	# ]
	# ///
	"""
	Generate a recap of issues assigned to specific milestones from the .issues/closed directory.

	This script parses Markdown files with YAML frontmatter and generates a formatted