Cleaning up the internals

[wooorm]

As @jxnblk mentioned in in GH-3,

I'm unsure about the preferred way to replace the parent node, so any pointers there would be helpful

...I think we should do this part properly.

I have some thoughts, but would like some context for the existence of this plugin. Here’s my understanding of how it currently works.

1. Find all images (or image references, soon)
2. If the found node has a parent that is a paragraph, and if that paragraph has one child
3. Assume that child is an image and swap that paragraph for the supposed image

So I’m guessing that step 2 is looking through ancestors, rather than just the last ancestor (the parent), for cases like *![img](#)*, where there’s a paragraph, with emphasis, with an image.
But step 3 contradicts this.

We can change step 2, or change step 3. But to figure out which one should be fixed, I need a better understanding of how this is used. Are there more examples of expected input/output?