Well, I was able to more or less fix the formatting (see this post), but some things have changed. The new version of Discourse started using Lightbox or it at least places it around certain images which winds up placing display: block on those images.
On top of that the details box which is this:
Details Box
Yup this is the details box
Has added some extra CSS it seems also and throws things off a bit.
All that said, I know on the Discourse Admin side of things you can add custom code and maybe there was some custom code overwritten by the upgrade and/or the new version has just changed things.
Not totally sure where to go from here, either some custom code is needed, the details plugin needs to be updated, or we need to find a new format other than the details.