Вставляется битая ссылка на тег

Да, вижу проблему.

Как это так работает? Линк же один и тот же.

Плюсы кодируются через %20. Наверное в этом дело.

Это он в тексте тот же, а в href другой. Плюсы криво закодировались.

Хорошо бы это оказался баг моего творчества, а не пришедший из flexmark-java.

Проблему локализовал, она в районе нашего кода который приводит внутренние ссылки к каноническому виду. При попытке поправить столкнулся с древнем злом, пока что пофиксить не удалось. Но надежда еще есть :-)

Пофиксил, надеюсь ничего при этом не сломал.

А тестами код покрывать тебя мама в детстве не учила?
Сломал — почини и напиши тест.
И на плюсы тоже тест напиши.

Тестов там много, и на плюсы я тест добавил. Но это тут случай когда тесты на качество кода существенно не влияют, из-за неопределенности в том как оно должно быть.

Должно быть так чтобы ничего не ломалось, очевидно же.
Если что-то может сломаться — оно должно быть покрыто тестами.

Это нужны тогда end to end тесты на селениуме или чем-то таком. Без этого нужна какая-то спецификация, по которой можно валидировать результат.

Для валидации путей в ссылках селениум не нужен.
Спецификация называется HTML.

Вот тут ты ошибаешься, как и авторы Apache HTTP Client, из которого пришел этот баг.

Нет, просто Apache HTTP Client тут лишний

Код открытый, можешь посмотреть где была проблема и как она была поправлена, если мне не веришь.

Проблема не в доверии, а в плохой архитектуре

Ты забыл оставить ссылку на хорошую архитектуру в твоем исполнении. Мы всем ЛОРом уже лет 10 ждем, кстати, только ради этого в игнор не добавляем. Будет?