https://commonmark.thephpleague.com/2.4/extensions/heading-permalinks/ - делает все заголовками ссылками с якорями.
https://commonmark.thephpleague.com/2.4/extensions/table-of-contents/ - добавляет в начале документа оглавление по которому можно переходить.
В целом оно работает из коробки, но его нужно донастраивать так, чтобы оно подходило к нашей стилистике, не вылезало там, где не надо, например в комментариях. И здесь же стоит подумать как этим пользоваться другим системам, например генерить ссылки на главу документа из другого документа.
Выделено из tndt-9, как отдельная задача.
Да, выглядят они уже нормлаьно, но с точки зрения разметки они не должны быть <h1>. На докмент должен быть только один <h1>. В качестве <h2> вероятно разделы, комментарии. остальное <h3> и далее.