markdocx 1__tar.gz → 3.0.0__tar.gz

{markdocx-1 → markdocx-3.0.0}/.gitignore

@@ -1,12 +1,12 @@
-# Python-generated files
-__pycache__/
-*.py[oc]
-build/
-dist/
-wheels/
-*.egg-info
-
-# Virtual environments
-.venv
-
-
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+

{markdocx-1 → markdocx-3.0.0}/.python-version

@@ -1 +1 @@
-3.14
+3.14

{markdocx-1 → markdocx-3.0.0}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 shynneri
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 shynneri
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{markdocx-1 → markdocx-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdocx
-Version: 1
+Version: 3.0.0
 Summary: Convert AI-generated Markdown textbooks to polished DOCX with native math equations and syntax-highlighted code
 License-Expression: MIT
 License-File: LICENSE
@@ -10,6 +10,7 @@ Requires-Dist: lxml==6.0.2
 Requires-Dist: markdown-it-py==4.0.0
 Requires-Dist: matplotlib==3.10.8
 Requires-Dist: mdit-py-plugins==0.5.0
+Requires-Dist: networkx>=3.6.1
 Requires-Dist: pillow==12.1.0
 Requires-Dist: pygments==2.19.2
 Requires-Dist: python-docx==1.2.0
@@ -17,12 +18,13 @@ Description-Content-Type: text/markdown
 
 <div align="center">
 
-# MD to DOCX
+# markdocx
 
 **A Markdown-to-Word converter built for AI-generated textbooks**
 
 Convert Markdown files — complete with LaTeX math, syntax-highlighted code, tables, and images — into polished `.docx` documents in one command.
 
+[![PyPI](https://img.shields.io/pypi/v/markdocx.svg)](https://pypi.org/project/markdocx/)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
@@ -38,7 +40,7 @@ Large language models (ChatGPT, Claude, Gemini, …) produce great Markdown, but
 - Code blocks lose their highlighting
 - Tables, lists, and blockquotes need manual reformatting
 
-**MD to DOCX** bridges that gap. Feed it a Markdown file that follows a few simple rules and get a publication-ready `.docx` — math rendered as native Word OMML equations, code with VS Code–style colors, and everything else properly formatted.
+**markdocx** bridges that gap. Feed it a Markdown file that follows a few simple rules and get a publication-ready `.docx` — math rendered as native Word OMML equations, code with VS Code–style colors, diagrams rendered as images, and everything else properly formatted.
 
 ## Features
 
@@ -48,6 +50,10 @@ Large language models (ChatGPT, Claude, Gemini, …) produce great Markdown, but
 | **Code** | 30+ languages with Pygments syntax highlighting, VS Code light theme, language labels |
 | **Tables** | Auto-formatted Table Grid — bold header row, left/center/right alignment, inline math in cells |
 | **Lists** | Bullet (•◦▪) and numbered lists, up to 6 nesting levels |
+| **Matrix** | `\`\`\`matrix` blocks → visual matrix diagrams with brackets, labels, and captions |
+| **Charts** | `\`\`\`chart` blocks → bar, line, pie, and scatter charts via matplotlib |
+| **Graphs** | `\`\`\`graph` blocks → network/graph diagrams with weighted edges via networkx |
+| **Workflows** | `\`\`\`workflow` blocks → flowcharts with decision diamonds, process boxes, and arrows |
 | **Other** | Blockquotes, horizontal rules, clickable hyperlinks, local images, footnotes |
 
 ## Quick Start
@@ -55,30 +61,53 @@ Large language models (ChatGPT, Claude, Gemini, …) produce great Markdown, but
 ### Installation
 
 ```bash
-git clone https://github.com/shynerri-source/markdocx.git
-cd markdocx
 # Using uv (recommended)
-uv sync
+uv add markdocx
 
 # Or using pip
-pip install -r requirements.txt
+pip install markdocx
 ```
 
+<details>
+<summary>Install from source (for development)</summary>
+
+```bash
+git clone https://github.com/shynerri-source/markdocx.git
+cd markdocx
+uv sync        # or: pip install -e .
+```
+
+</details>
+
 ### Usage
 
+#### CLI
+
 ```bash
 # Convert a single file
-python main.py input.md
-python main.py input.md -o output.docx
+markdocx input.md
+markdocx input.md -o output.docx
 
 # Convert an entire directory
-python main.py ./chapters/ -o ./output/
+markdocx ./chapters/ -o ./output/
 
 # Recursively search subdirectories
-python main.py ./chapters/ -o ./output/ -r
+markdocx ./chapters/ -o ./output/ -r
 
 # Verbose logging
-python main.py input.md -v
+markdocx input.md -v
+```
+
+#### Python API
+
+```python
+from markdocx import convert_file, convert_directory
+
+# Single file
+convert_file("input.md", "output.docx")
+
+# Entire directory
+results = convert_directory("./chapters/", output_dir="./output/", recursive=True)
 ```
 
 ### CLI Options
@@ -100,9 +129,10 @@ Markdown file
      │
      ▼
  docx_builder.py     ─── walks the token stream, builds Word elements
-     ├── math_renderer.py   ─── LaTeX → MathML → OMML (native Word equations)
-     ├── code_renderer.py   ─── Pygments lexer → colored Word runs
-     └── styles.py          ─── fonts, colors, spacing presets
+     ├── math_renderer.py      ─── LaTeX → MathML → OMML (native Word equations)
+     ├── code_renderer.py      ─── Pygments lexer → colored Word runs
+     ├── diagram_renderer.py   ─── matrix / chart / graph / workflow → PNG images
+     └── styles.py             ─── fonts, colors, spacing presets
      │
      ▼
   .docx file          ─── python-docx output
@@ -122,21 +152,72 @@ LaTeX string → latex2mathml → MathML → XSLT → OMML → Word paragraph
 Source code → Pygments lexer + VS Code theme → colored Word runs inside a shaded table cell
 ```
 
+### Diagram Pipeline
+
+Fenced code blocks with special language identifiers (`matrix`, `chart`, `graph`, `workflow`) are rendered as PNG images via matplotlib/networkx and embedded in the document.
+
+````markdown
+```matrix
+name: A
+1 2 3
+4 5 6
+7 8 9
+caption: Matrix A (3×3)
+```
+
+```chart
+type: bar
+title: Algorithm Performance
+labels: Bubble Sort, Merge Sort, Quick Sort
+Time (ms): 450, 38, 35
+caption: Figure 1: Sorting comparison
+```
+
+```graph
+directed: true
+title: Shortest Path
+A -> B: 5
+B -> C: 3
+A -> C: 7
+caption: Figure 2: Weighted directed graph
+```
+
+```workflow
+title: Login Process
+[Start]
+<User Input>
+(Validate Credentials)
+{Valid?}
+(Grant Access)
+[End]
+caption: Figure 3: Authentication workflow
+```
+````
+
+| Block type | Formats | Rendered via |
+|:-----------|:--------|:-------------|
+| `matrix` | Simple text or JSON | matplotlib |
+| `chart` | Simple key-value or JSON — bar, line, pie, scatter | matplotlib |
+| `graph` | Edge list (`A -> B: 5`) or JSON — directed/undirected | matplotlib + networkx |
+| `workflow` | Step notation (`[Start]`, `(Process)`, `{Decision}`, `<I/O>`) or JSON | matplotlib |
+
 ## Project Structure
 
 ```
-md_to_docx/
-├── main.py                  # CLI entry point
+markdocx/
+├── main.py                  # Convenience entry point
 ├── pyproject.toml           # Project metadata & dependencies
-├── requirements.txt         # Pip-compatible dependency list
-├── converter/
-│   ├── __init__.py
-│   ├── core.py              # Top-level orchestrator
-│   ├── md_parser.py         # Markdown → token stream
-│   ├── math_renderer.py     # LaTeX → OMML (native Word math)
-│   ├── code_renderer.py     # Code → syntax-highlighted Word runs
-│   ├── docx_builder.py      # Token stream → DOCX elements
-│   └── styles.py            # Fonts, colors, and layout presets
+├── src/
+│   └── markdocx/            # Installable package
+│       ├── __init__.py      # Public API (convert_file, convert_directory)
+│       ├── cli.py           # CLI entry point (markdocx command)
+│       ├── core.py          # Top-level orchestrator
+│       ├── md_parser.py     # Markdown → token stream
+│       ├── math_renderer.py    # LaTeX → OMML (native Word math)
+│       ├── code_renderer.py    # Code → syntax-highlighted Word runs
+│       ├── diagram_renderer.py # Matrix / Chart / Graph / Workflow → PNG
+│       ├── docx_builder.py     # Token stream → DOCX elements
+│       └── styles.py           # Fonts, colors, and layout presets
 └── rule/
     ├── ai_gen_doc_rule.md      # AI writing rules (Vietnamese)
     └── ai_gen_doc_rule_en.md   # AI writing rules (English)
@@ -152,8 +233,9 @@ md_to_docx/
 | [latex2mathml](https://github.com/roniemartinez/latex2mathml) | 3.78.1 | LaTeX → MathML conversion |
 | [lxml](https://lxml.de/) | 6.0.2 | XML/XSLT processing |
 | [Pygments](https://pygments.org/) | 2.19.2 | Syntax highlighting |
-| [matplotlib](https://matplotlib.org/) | 3.10.8 | LaTeX rendering (fallback) |
+| [matplotlib](https://matplotlib.org/) | 3.10.8 | Chart, matrix, workflow rendering |
 | [Pillow](https://python-pillow.org/) | 12.1.0 | Image processing |
+| [networkx](https://networkx.org/) | 3.4+ | Graph/network diagram layouts |
 
 ## AI Writing Rules