I would really find it helpful if i could dump file name headings on each code snippet. I’m not sure what you are deprecating highlight.js with, but prism.js lets you have these. Example below, from here https://www.taniarascia.com/es6-syntax-and-feature-overview/.
How it would work is if there is text directly adjacent to the ``` triple backticks like so, it would be triggered.
Yellow indicates linebreak so no filename is triggered
Alternatively , possibly have a setting to show what language the file is in as well would work. See here on prism.js