Best way to convert HTML Markdown in VTEX without losing functionality?

Hey everyone 👋

I’m currently working as part of a team that runs an e-commerce platform built on VTEX. I know the community is pretty divided on it – some consider it powerful and scalable, others find it too rigid and restrictive. That said, this post isn’t about debating VTEX itself.

I’m trying to solve a more specific technical challenge: converting HTML content into Markdown without losing too much of its original functionality (structure, styles, layout behavior, etc.).
From the research I’ve done so far, it seems like a clean, one-to-one conversion is pretty much impossible — at least not without a lot of manual rewriting or compromises.

The main reason Markdown is non-negotiable in my case is because VTEX accepts Markdown natively in certain content areas, while HTML is either limited or not supported at all.

Has anyone here faced a similar situation before?
Are there any tools, libraries, or workflows you’d recommend that help preserve key HTML functionality when converting to Markdown? Even partial solutions, best practices, or clever workarounds would be super helpful 🙏

Thanks in advance for any insights or ideas you can share! 💡