Converting LyX Documents to Markdown: Preserving Academic Math and Outlines

LyX is a popular open-source document processor built on the paradigm of What You See Is What You Mean (WYSIWYM). Rather than wrestling with manual LaTeX code tags, braces, and compilation scripts, academic authors, mathematicians, and technical writers use LyX to compose structured documents with real-time visual equations, automated numbering, and cross-references.

However, sharing .lyx files with collaborators outside the LyX ecosystem is notoriously cumbersome. Exporting to standard GitHub Flavored Markdown (GFM) makes academic research instantly accessible on GitHub, documentation sites, static site generators, and modern knowledge bases like Obsidian and Notion.

---

1. The LyX Document Format

LyX saves documents as structured plain text containing document headers, paragraph layout directives, and hierarchical nested insets:

#LyX 2.3 created this file. For more info see http://www.lyx.org/
\lyxformat 544
\begin_document
\begin_header
\textclass article
\end_header
\begin_body
\begin_layout Section
Quantum Decoherence in Open Systems
\end_layout
\begin_layout Standard
The evolution of the reduced density matrix is governed by:
\begin_inset Formula 
\[
\frac{d\rho}{dt} = -\frac{i}{\hbar}[H, \rho] + \mathcal{L}_D[\rho]
\]
\end_inset
\end_layout
\end_body
\end_document

---

2. Converting Semantic Insets to Markdown

A high-fidelity LyX-to-Markdown converter must map semantic layout structures into standard Markdown constructs:

• Sectioning Layouts: \begin_layout Section, Subsection, Subsubsection map to #, ##, ###.
• Lists and Enumerate: \begin_layout Itemize and \begin_layout Enumerate map to unordered (-) and ordered (1.) markdown lists.
• Mathematical Insets: \begin_inset Formula $...$ maps to inline math $...$, while display formulas \[...\] map to standard fenced math blocks $$...$$.
• Tabular Insets: \begin_inset Tabular tables with rows and cells parse into standard GFM markdown tables.
• Graphics & Links: Image insets \begin_inset Graphics and URL insets \begin_inset Flex URL convert into markdown image and hyperlink tags.

---

3. Offline Privacy for Sensitive Research

Academic preprints, grant applications, and peer reviews often contain confidential or unreleased intellectual property. convrtr parses and converts .lyx files 100% in-browser using pure client-side TypeScript. Your documents, draft theorems, and private notes are never uploaded to any remote server.