Having the dashes to make something a headline on another row disconnects meaning. You now have to edit two lines to make one change.

Same for the code part.

This might be easier to read but it’s not simpler.