Estimated reading time at 200 wpm: 4 minutes
1. Introduction
The motivation for this workflow exploration was the necessity of converting existing Microsoft Word documents (.docx) into well-structured Markdown (.md) files automatically. While Markdown is an ideal format for documentation, version control, and lightweight text editing (such as in Typora), manual conversion or reliance on simple tools often results in corrupted formatting, particularly with complex elements like tables and equations. A solution was required to maintain document fidelity and streamline the conversion process.
Whether or not you agree our Fat Disclaimer applies
Nobody needs to change from MS Word to Typora. I’m not doing that. Not everybody needs Markdown files either, and therefore to use Typora. And certainly not everybody even knows what Markdown means. Just to be clear, this does not mean I’m sitting behind a keyboard tapping away at code of any kind.
2. Initial Exploration
Initial attempts at achieving high-quality conversion relied on Pandoc, a powerful command-line interface (CLI) tool. Pandoc is highly regarded for its robust, complex, and reliable document conversion capabilities. The existing workflow successfully utilised Pandoc for Markdown-to-DOCX export.
However, the requirement to perform the inverse conversion (DOCX-to-Markdown) without resorting to CLI commands presented a friction point. A solution was sought that encapsulated Pandoc’s conversion power within a simple, non-command-line interface, while maintaining an offline, secure processing environment that avoided the privacy risks associated with online converters.
3. Decision-making to Opt for Writage
Two primary non-CLI, offline options were considered: a low-cost, dedicated Microsoft Store application (DocX to MD Converter) and the dedicated Microsoft Word plugin, Writage. The decision favoured Writage due to its superior conversion engine integration and feature set, despite its higher cost.
| Feature | Writage (£23 / 29 USD) | DocX to MD Converter (£4.19) |
|---|---|---|
| Conversion Engine | Pandoc-based (High Quality) | Dedicated App (Quality Varies) |
| Workflow Integration | Seamless MS Word Plugin (File => Save As) | Separate Standalone Application |
| Conversion Direction | Bi-directional: DOCX to Markdown | Single Direction: DOCX Markdown (Primary) |
| Complex Formatting | Excellent: Supports Tables, Footnotes, Math, Code Blocks | Poor: Known to lack support for Tables |
| Maths/Equations | Guaranteed \LaTeX conversion via Word Editor | Limited/Unspecified Support |
Writage’s integration into the Word interface and its ability to correctly handle complex tables and math (via Pandoc) justified the investment, providing a low-friction, high-fidelity conversion.
4. Testing and Results
The conversion quality was tested using complex mathematical expressions that typically challenge standard conversion tools. The process involved inputting pure LaTeX code into the Microsoft Word Equation Editor and exporting via Writage.
Einstein Field Equations (EFE): The formula for the EFE was correctly converted, demonstrating support for general tensor notation.
[G_{\mu\nu} + \Lambda\, g_{\mu\nu}
= \frac{8\pi G}{c^{4}}\, T_{\mu\nu}
]
The famous equation is (E = mc^2).
Writage code tested: G{\mu\nu} + \Lambda g{\mu\nu} = \frac{8\pi G}{c\^4} T_{\mu\nu}
Riemann Curvature Tensor: The tensor formula, which includes multiple partial derivatives (\partial), Christoffel symbols (\Gamma), and mixed indices, was successfully converted.
Code tested: R\^{\rho}{\sigma\mu\nu} = \partial{\mu}\Gamma\^{\rho}{\nu\sigma} – \partial{\nu}\Gamma\^{\rho}{\mu\sigma} + \Gamma\^{\rho}{\mu\lambda}\Gamma\^{\lambda}{\nu\sigma} – \Gamma\^{\rho}{\nu\lambda}\Gamma\^{\lambda}_{\mu\sigma}
The Workflow Confirmation: All equations converted perfectly into the final .md file and rendered correctly in Typora, confirming a dependable, automated process for complex technical documents.
Did I say that I was not sitting behind a keyboard tapping away at code? Just checking. Yes I did! But..but..everybody has choice, to believe that or not!
5. Conclusions and Takeaway Points
The use of the Writage plugin establishes a robust and reliable workflow for converting professional Word documents into high-quality Markdown. The key takeaway points are:
- Automation of Complexity: The plugin successfully automates the conversion of complex document structures (headings, lists, tables) and advanced LaTeX math.
- Guaranteed Math Fidelity: By leveraging Word’s native Equation Editor, the conversion to LaTeX is guaranteed to be clean and standardised, preventing the manual errors that often break web-based renderers like KaTeX/MathJax.
- Low Friction: The conversion is reduced to a single File Save As step within Microsoft Word, eliminating the need for command-line instructions or external tools.
- Bi-directional Capability: The ability of Writage to also open and edit Markdown files directly in Word provides maximum flexibility for working across different publishing platforms and word processors.
