Modulus010

Modulus010 / thesis-builder

Public

用 Markdown 写论文，自动生成格式合规的 Word 文档。NEU thesis compiler: Markdown DSL → AST → .docx

26
3
89% credibility
Found May 19, 2026 at 26 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

This is a thesis formatting tool designed specifically for Northeastern University students. It takes a simple text file written in Markdown and converts it into a complete, properly formatted Word document that meets the university's strict thesis requirements. The tool automatically handles the complex formatting details—like cover pages in both Chinese and English, proper heading styles, figure and table numbering, reference formatting, and page layouts—so students can focus on writing their content instead of wrestling with Word's formatting tools. It also includes a validation feature that checks the thesis for common issues before generating the final document.

How It Works

1
📝 Write your thesis in simple text

You write your entire thesis using a straightforward text format that anyone can learn in minutes, including your title, chapters, images, and references.

2
🔍 Let the tool check your work

Before creating your final document, the tool reviews everything to make sure you have all the required sections and that nothing is missing.

3
✨ See any problems right away

You get a clear report showing if your abstract is too short, if you're missing required chapters, or if any references aren't being used in your text.

4
📄 Create your formatted document

With one simple command, your text transforms into a complete Word document with proper university formatting, cover pages, and page numbers.

5
Your thesis is ready
🇨🇳
Chinese cover page

A properly formatted title page with your name, student ID, major, and advisor

🇬🇧
English cover page

A bilingual title page showing your work to an international audience

📋
Table of contents

An automatically generated table of contents that updates in Word

🎉 Your thesis is complete and ready to submit

You now have a professionally formatted document that meets all your university's requirements, so you can focus on what matters most—your research.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 26 to 26 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is thesis-builder?

A Python tool that converts Markdown into formatted Word documents specifically for Northeastern University undergraduate theses. You write in a custom Markdown dialect with directives for figures, tables, code blocks, and PlantUML diagrams, then run a CLI command to generate a fully compliant .docx file. The pipeline parses your source, validates content against university requirements (abstract length, keyword counts, reference citations), and builds the document with proper Chinese academic formatting including covers, abstracts, table of contents, and page numbering.

Why is it gaining traction?

This solves a real pain point for Chinese CS students: wrestling with Word's formatting while trying to focus on actual content. The built-in content checker is the standout feature—it flags abstract字数不足, missing chapter summaries, and references cited out of order before you submit. The YAML configuration lets you tweak fonts, margins, and spacing without touching code, and the migration tool can extract content from existing Word documents back into Markdown for editing.

Who should use this?

Northeastern University students writing undergraduate graduation theses who want to write in Markdown and avoid Word formatting hell. It's also useful for thesis agents and builders that need to generate compliant academic documents programmatically. If you're outside NEU, the architecture is transferable but you'd need to customize the format configuration.

Verdict

At 26 stars with a credibility score of 0.9%, this is early-stage but functional. The code is clean and well-structured, with a complete pipeline from parsing through validation to document generation. The main risks are limited community support and no visible test suite. If you're at NEU and tired of fighting Word styles, this is worth trying—just budget time for troubleshooting edge cases. For production use at other institutions, expect to invest effort in adapting the format configuration.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.