# Keldos-Li/typora-latex-theme: a LaTeX-style Chinese theme for Typora course papers > A GPL-3.0 SCSS theme that makes Typora render Markdown as Chinese LaTeX-style coursework, tuned to Zhejiang University formatting. It fits short undergraduate essays, not theses or journal submissions. **Keldos-Li/typora-latex-theme** — 将Typora伪装成LaTeX的中文样式主题，本科生轻量级课程论文撰写的好帮手。This is a theme disguising Typora into Chinese LaTeX style. - Repository: https://github.com/Keldos-Li/typora-latex-theme - Stars: 5,975 · Forks: 334 - Language: SCSS - License: GPL-3.0 - Published: 2026-09-22 · Updated: 2026-09-22 · Language: en - Canonical page: https://hysenlabs.com/projects/keldos-li-typora-latex-theme ## What typora-latex-theme solves, and who it is actually for The README is explicit about the target: it exists to reduce the burden of writing small general-education course papers and small lab reports, aimed at undergraduates in mainland China. The styling follows Zhejiang University's requirements, which the README describes as using smaller fonts and smaller page margins than typical. That is a narrow audience by design, and the README says most students can adjust the CSS themselves to match their own school. The problem it addresses is real. LaTeX produces the typography Chinese course papers expect, but it asks you to learn a build system, manage packages, and fight compilation errors for a document that might be eight pages long. Typora is a Markdown editor with live preview, so the writing loop is fast. This theme sits in the gap: you write Markdown, and the preview and the exported PDF look like LaTeX output. It is not a LaTeX replacement for anything long or structurally demanding. ## How the theme works: SCSS compiled into Typora CSS The repository is mostly SCSS, with source under src/ and shipped assets under resources/. Typora themes are CSS files placed in the editor's theme folder, so the project's real work is authoring the stylesheet that maps Markdown elements onto LaTeX-like presentation. The top-level layout (src/, resources/, plus .github/, CONTRIBUTING.md, credits.md and LICENSE) matches a theme that is built from source and then packaged per platform. What that means in practice is that every visual decision is a CSS rule, not a document class. Headings, tables, code blocks, Mermaid diagrams and display equations are all styled by selectors. The README's examples show how far this goes: a table caption is written as raw HTML inside Markdown, and an equation is a LaTeX block with a manual tag. The theme cannot renumber your figures or resolve cross-references. Numbering is something you type. That is the central trade-off, and it is worth understanding before you commit a paper to it. Because the source is SCSS, changing fonts, margins or heading sizes means editing variables and recompiling, or editing the generated CSS directly. The README points to a wiki page on personalization for this, and credits two upstream projects, yfzhao20/Typora-markdown and du33169/typora-theme-essay_cn, as the basis it was built on. ## Installing typora-latex-theme from the release zip The README's install path has three steps and assumes Typora is already installed and you already know Markdown. First, go to the releases page and download the archive for your operating system. The README gives the example that on Windows you download `latex-theme-windows.zip`. Extract it, then follow the installation guide in the wiki or the `README.md` inside the extracted folder. The README marks two steps as mandatory: performing the manual or automatic theme installation, and downloading and installing the required fonts. Skipping the fonts is the most common way to get a document that looks wrong, because the theme's typography depends on them. Once installed, the first real use is to open a Markdown file in Typora and select the theme from the theme menu. A table caption in the README's style is written as raw HTML above a Markdown table: ```markdown
表 2 全球/中国桌面操作系统市场份额占比（%）
| OS | Windows | macOS | Unknown | Linux | Chrome OS | 其他 | | ---- | ------- | ----- | ------- | ----- | --------- | ---- | | 全球 | 76.56 | 17.1 | 2.68 | 1.93 | 1.72 | 0.01 | | 中国 | 87.55 | 5.44 | 6.24 | 0.75 | 0.01 | 0.01 | ``` Display equations use standard LaTeX delimiters, with the equation number typed manually: ```latex $$ \iint\limits_{x^2 + y^2 \leq R^2} f(x,y)\,\mathrm{d}x\,\mathrm{d}y = \int_{\theta=0}^{2\pi} \mathrm{d}\theta\int_{r=0}^R f(r\cos\theta,r\sin\theta) r\,\mathrm{d}r\, \tag{1} $$ ``` What you should see is the preview rendering in the LaTeX-like style, and an exported PDF that matches it. The README also offers an online PDF preview and a video walkthrough if you want to check the output before installing. ## Where the theme breaks down The most important limitation is that this is a stylesheet, not a typesetting engine. LaTeX tracks counters and resolves references; CSS does not. The README's own table example puts the caption text and the table number in a hand-written HTML line. If you reorder sections or insert a figure, every downstream number is yours to fix manually. For an eight-page course paper that is tolerable. For anything with thirty numbered objects it becomes a source of errors that a real LaTeX document would not have. The second limitation is the format lock-in. The README states the theme basically adopts Zhejiang University's required format. If your school specifies different margins, a different heading hierarchy or a mandatory cover page, the theme does not ship a switch for that; the README's answer is that most students can modify the CSS themselves. That is a reasonable answer for someone comfortable with stylesheets and a dead end for someone who is not. The third is that the project is a theme for one editor. It has no standalone converter, so the workflow depends on Typora being the tool you write in. And the README does not document rollback or an uninstall procedure, so if a new theme version changes your layout mid-semester, the wiki is the place to look rather than the README. ## typora-latex-theme compared with writing in LaTeX directly The obvious alternative is LaTeX itself, typically through a Chinese thesis template such as a ctex-based document class. The difference in approach is fundamental. LaTeX separates content from a document class that owns numbering, cross-references, bibliography and page geometry; the class enforces the format and you cannot accidentally break it. This theme does the opposite: it styles what Markdown already produces and leaves all structure to you. You gain a live preview and a syntax you probably already know, and you give up automatic numbering and any guarantee that your document is internally consistent. A second alternative is simply using Typora's built-in themes or another Typora theme, and accepting ordinary Markdown typography. That is lighter still, but it will not produce the LaTeX-like look the README is selling. The honest framing is that this project trades structural correctness for writing speed, and the trade only pays off at short document lengths. ## Maintenance, licence and the cost of upgrading The repository is not archived, and the last push was on 2026-04-26. Releases are infrequent: v0.3.1 in November 2024, v0.3.2 in February 2025, and v0.3.3 in November 2025. That cadence suggests a project that is finished enough to be stable rather than one adding features continuously. Budget for occasional updates rather than a steady stream. The upgrade cost is real if you have customized anything. Because the theme ships as CSS generated from SCSS, any local edit you make to fonts or margins lives in the same files a new release replaces. Keep a copy of your changes somewhere outside the theme folder, or track which variables you touched, otherwise a version bump silently reverts your school's formatting. The licence is GPL-3.0. That is a copyleft licence, and it matters if you plan to redistribute a modified theme: derivative distributions generally have to carry the same licence terms. Using the theme to produce a paper is a different question from redistributing the theme, and the LICENSE file in the repository is the authoritative text. This is not legal advice; if you intend to ship a modified version, read the licence or ask someone qualified. ## Conclusion Adopt it if you are a Chinese undergraduate writing short general-education papers or lab reports in Typora and want LaTeX-like typography without a TeX toolchain. Do not adopt it for a degree thesis, a journal submission, or any document with a strict institutional template that differs from Zhejiang University's, because the README states the styling follows that school's requirements and only suggests editing the CSS yourself. Before you rely on it, verify three things: that your Typora version is the one the theme targets, that the fonts named in the wiki install guide are actually present on your machine, and that your school's format rules match what the theme renders. ## FAQ ### What is Keldos-Li/typora-latex-theme used for? It is a Typora theme that makes the editor render and export Markdown in a Chinese LaTeX-like style. The README says it was created to simplify writing small general-education course papers and small lab reports for undergraduates in mainland China. ### Can typora-latex-theme output a PDF? The workflow is Typora's own export, since the theme controls how the document renders in the editor and in exported output. The README points to an online PDF preview so you can see the exported result before installing. ### How do I install typora-latex-theme? Download the archive for your operating system from the releases page, for example latex-theme-windows.zip on Windows, extract it, then follow the wiki installation guide or the README.md inside the folder. The README lists installing the theme and installing the required fonts as steps you must complete. ### Does typora-latex-theme work on Windows, macOS and Linux? The README states the project supports Typora on Windows, macOS and Linux, and the release archives are named per platform. ## Sources - [Issues](https://github.com/Keldos-Li/typora-latex-theme/issues) - [Keldos-Li/typora-latex-theme on GitHub](https://github.com/Keldos-Li/typora-latex-theme) - [License: GPL-3.0](https://github.com/Keldos-Li/typora-latex-theme/blob/main/LICENSE) - [README](https://github.com/Keldos-Li/typora-latex-theme/blob/main/README.md) - [Releases](https://github.com/Keldos-Li/typora-latex-theme/releases) --- Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/keldos-li-typora-latex-theme