Skip to content

Repository files navigation

Pre-release Update

Evolving into SciMAt v1.5.6-beta

Testing new features and expanding the automation engine.

Currently in Development

  • Chemical Formula Engine
  • Improved Periodic Table support
  • Automatic formatting for molecules
  • Detection and formatting of ions and their charges

Ongoing Work

The project is gradually evolving from a document automation tool into SciMAt (Scientific Manuscript Assistant), with a focus on improving scientific writing, formatting, and reporting workflows within Microsoft Word.

⚠️ This is a pre-release build intended for testing. Features may change as development continues.

Example - Chemistry

Markdown Formula to MS Word Equation Converter

Developed by Kartik Agrawat


🧐 What Is This? (The Problem It Solves)

Have you ever copied text containing mathematical formulas (Lambda, Gamma, fractions, etc.) or chemical formulas (like H2O, NH3, CO2, etc.) after copy-pasting it from an external source, only to find it turns into messy Markdown code full of dollar signs inside Microsoft Word?

For example, instead of a clean, professional equation, you get something ugly like this:

The formula is $NH_3$ and the variance is $$\sigma_x^2$$

Normally, you would have to spend hours manually re-typing every single symbol using Word's tedious equation editor.

This tool fixes that instantly. It installs a permanent, custom 1-click button directly at the top of your Microsoft Word window. When you paste your text, you simply click your new button, and all that messy code instantly snaps into beautiful, professional, and fully editable Microsoft Word math equations or chemical formulas!

📸 Before Installation

This is how messy the raw Markdown formatting looks when pasted directly into Microsoft Word:

Messy Markdown text inside Word


🛠️ How to Install It (1-Click Setup)

You don’t need to know anything about coding or system settings to get this running.

  1. Download this project folder to your computer.
  2. Make sure Microsoft Word is closed.
  3. Double-click the file named Setup.bat.

That's it! A small command window will flash for a second to automatically place the components into Word's hidden startup directory. Once it finishes, the setup is permanently complete.

📸 After Installation

Once the installer finishes running, your custom butterfly-shaped shortcut will appear permanently pinned to the top header of your desktop app:

Custom butterfly icon visible in Word top toolbar


🚀 How to Use It

Using the tool is incredibly simple:

  1. Open Microsoft Word (any old file or a brand-new blank document).
  2. Copy your text and paste it normally into Word.
  3. Look at the very top left corner of your Word screen (above the standard "Home" ribbon toolbar) to locate your custom butterfly icon.
  4. Click the butterfly icon once.
  5. Watch all the raw symbols and dollar signs instantly transform into clean, native mathematical equations or chemical formulas!

Clicking the butterfly icon converts the formulas instantly


📂 What's Inside the Folder?

  • MarkdownConverter.dotm: This is the master blueprint file. It holds the safe, automated background instructions and the visual layout for your new button.
  • Setup.bat: The automated installer engine. It takes the blueprint file and cleanly drops it into the exact folder Microsoft Word looks at when booting up.
  • Uninstaller.bat: The automated clean-up utility. Running this safely shuts down active Word instances and completely removes the add-in from your system toolbar.
  • README.md: The rich-text documentation layout built specifically for the GitHub homepage interface.
  • Read Me by Kartik Agrawat.txt: A clean, plain-text version of the instructions designed to open perfectly inside standard Windows Notepad.
  • Step 1 Before Intallation.png: Visual example showing raw Markdown dollar signs pasted inside a document.
  • Step 2 After Installation.png: Visual verification showing the butterfly icon successfully loaded onto the Quick Access Toolbar.
  • Step 3 Click on icon to Convert.png: Visual proof demonstrating the final rendered native equations after clicking the conversion tool.

💻 System Compatibility

This tool works perfectly on all standard Windows desktop versions of Microsoft Word (from Word 2010 all the way up to Word 2024 and Microsoft 365), but it will not run on Mac (Apple) computers, mobile apps, or the free web browser version of Word.


🌟 Support & Portfolio

This tool is open-source and free to use! If it saved you hours of manual formatting, feel free to star the repository.


🤝 Credits & How It Was Made

  • Concept, Workflow Logic & Testing: Kartik Agrawat
  • Technical Scripting: Developed in collaboration with AI

A Note from the Creator: I do not come from a traditional computer science background and do not write code from scratch. Instead, I identified a massive, repetitive bottleneck while trying to format study papers and data text.

I mapped out the logical steps required to fix the issue, designed the user experience (making it a permanent 1-click button for ease of use), tested the edge cases, and collaborated with an AI assistant to generate and refine the underlying code library. This project is a practical example of how non-programmers can use AI to build real, functioning tools to solve daily productivity problems.

About

A 1-click MS Word add-in that instantly format chemical formulas and math equations. Usefull for science teachers, students, and researchers!

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages