markdocx 0.1.0__py3-none-any.whl

markdocx/styles.py

@@ -0,0 +1,248 @@
+"""
+Document styles configuration.
+Định nghĩa font, kích thước, màu sắc cho tài liệu giáo trình.
+"""
+
+from docx.shared import Pt, Inches, RGBColor, Cm, Emu
+from docx.enum.text import WD_ALIGN_PARAGRAPH, WD_LINE_SPACING
+from docx.enum.table import WD_TABLE_ALIGNMENT
+from docx.oxml import OxmlElement
+from docx.oxml.ns import qn
+
+
+# ── Font Configuration ──────────────────────────────────────────────
+FONT_BODY = "Times New Roman"
+FONT_HEADING = "Arial"
+FONT_CODE = "Consolas"
+
+FONT_SIZE_BODY = Pt(12)
+FONT_SIZE_CODE = Pt(9.5)
+FONT_SIZE_CODE_BLOCK = Pt(9)
+FONT_SIZE_SMALL = Pt(10)
+
+# ── Heading Sizes ───────────────────────────────────────────────────
+HEADING_SIZES = {
+    1: Pt(22),
+    2: Pt(18),
+    3: Pt(15),
+    4: Pt(13),
+    5: Pt(12),
+    6: Pt(11),
+}
+
+HEADING_COLORS = {
+    1: RGBColor(0x1A, 0x23, 0x7E),    # Deep Blue
+    2: RGBColor(0x28, 0x3E, 0x9A),    # Medium Blue
+    3: RGBColor(0x37, 0x47, 0x4F),    # Dark Gray Blue
+    4: RGBColor(0x45, 0x55, 0x60),    # Gray
+    5: RGBColor(0x54, 0x64, 0x6E),    # Medium Gray
+    6: RGBColor(0x60, 0x70, 0x7A),    # Light Gray
+}
+
+# ── Colors ──────────────────────────────────────────────────────────
+COLOR_BODY_TEXT = RGBColor(0x21, 0x21, 0x21)
+COLOR_LINK = RGBColor(0x05, 0x63, 0xC1)
+COLOR_INLINE_CODE_BG = "E8E8E8"
+COLOR_CODE_BLOCK_BG = "F8F8F8"
+COLOR_CODE_BLOCK_BORDER = "DDDDDD"
+COLOR_BLOCKQUOTE_BORDER = "BBBBBB"
+COLOR_BLOCKQUOTE_TEXT = RGBColor(0x55, 0x55, 0x55)
+COLOR_TABLE_HEADER_BG = "E3F2FD"
+COLOR_TABLE_BORDER = "BBBBBB"
+COLOR_HR = "CCCCCC"
+
+# ── Spacing ─────────────────────────────────────────────────────────
+LINE_SPACING = 1.15
+PARA_SPACE_BEFORE = Pt(3)
+PARA_SPACE_AFTER = Pt(6)
+HEADING_SPACE_BEFORE = Pt(18)
+HEADING_SPACE_AFTER = Pt(8)
+CODE_BLOCK_SPACE = Pt(6)
+LIST_INDENT = Inches(0.35)
+
+# ── Page Setup ──────────────────────────────────────────────────────
+PAGE_MARGIN_TOP = Cm(2.54)
+PAGE_MARGIN_BOTTOM = Cm(2.54)
+PAGE_MARGIN_LEFT = Cm(2.54)
+PAGE_MARGIN_RIGHT = Cm(2.54)
+
+# ── Math ────────────────────────────────────────────────────────────
+MATH_DPI = 300
+MATH_FONTSIZE_INLINE = 14
+MATH_FONTSIZE_DISPLAY = 16
+MATH_MAX_WIDTH = Inches(5.5)
+MATH_INLINE_HEIGHT = Inches(0.22)
+
+# ── Code Syntax Colors (VS Code-like theme) ────────────────────────
+from pygments.token import Token
+
+SYNTAX_COLORS = {
+    Token.Keyword:                  RGBColor(0x00, 0x00, 0xCC),     # Blue
+    Token.Keyword.Constant:         RGBColor(0x00, 0x00, 0xCC),
+    Token.Keyword.Declaration:      RGBColor(0x00, 0x00, 0xCC),
+    Token.Keyword.Namespace:        RGBColor(0x7B, 0x30, 0x7B),     # Purple
+    Token.Keyword.Type:             RGBColor(0x26, 0x7F, 0x99),     # Teal
+    Token.Name.Function:            RGBColor(0x79, 0x5E, 0x26),     # Dark Yellow
+    Token.Name.Function.Magic:      RGBColor(0x79, 0x5E, 0x26),
+    Token.Name.Class:               RGBColor(0x26, 0x7F, 0x99),     # Teal
+    Token.Name.Decorator:           RGBColor(0x79, 0x5E, 0x26),     # Dark Yellow
+    Token.Name.Builtin:             RGBColor(0x26, 0x7F, 0x99),     # Teal
+    Token.Name.Builtin.Pseudo:      RGBColor(0x00, 0x00, 0xCC),
+    Token.Literal.String:           RGBColor(0xA3, 0x15, 0x15),     # Red
+    Token.Literal.String.Doc:       RGBColor(0xA3, 0x15, 0x15),
+    Token.Literal.String.Single:    RGBColor(0xA3, 0x15, 0x15),
+    Token.Literal.String.Double:    RGBColor(0xA3, 0x15, 0x15),
+    Token.Literal.String.Escape:    RGBColor(0xEE, 0x00, 0x00),
+    Token.Literal.String.Interpol:  RGBColor(0xEE, 0x00, 0x00),
+    Token.Literal.String.Affix:     RGBColor(0x00, 0x00, 0xCC),
+    Token.Literal.Number:           RGBColor(0x09, 0x88, 0x58),     # Green
+    Token.Literal.Number.Integer:   RGBColor(0x09, 0x88, 0x58),
+    Token.Literal.Number.Float:     RGBColor(0x09, 0x88, 0x58),
+    Token.Comment:                  RGBColor(0x6A, 0x99, 0x55),     # Olive Green
+    Token.Comment.Single:           RGBColor(0x6A, 0x99, 0x55),
+    Token.Comment.Multiline:        RGBColor(0x6A, 0x99, 0x55),
+    Token.Comment.Hashbang:         RGBColor(0x6A, 0x99, 0x55),
+    Token.Operator:                 RGBColor(0x33, 0x33, 0x33),
+    Token.Operator.Word:            RGBColor(0x00, 0x00, 0xCC),
+    Token.Punctuation:              RGBColor(0x33, 0x33, 0x33),
+    Token.Name.Tag:                 RGBColor(0x80, 0x00, 0x00),     # HTML tags
+    Token.Name.Attribute:           RGBColor(0xFF, 0x00, 0x00),     # HTML attrs
+}
+
+
+def get_syntax_color(token_type):
+    """Get color for a Pygments token type, walking up the hierarchy."""
+    t = token_type
+    while t:
+        if t in SYNTAX_COLORS:
+            return SYNTAX_COLORS[t]
+        t = t.parent
+    return None
+
+
+# ── XML Helpers ─────────────────────────────────────────────────────
+
+def set_paragraph_shading(paragraph, fill_color):
+    """Set background color for an entire paragraph."""
+    pPr = paragraph._element.get_or_add_pPr()
+    shd = OxmlElement("w:shd")
+    shd.set(qn("w:val"), "clear")
+    shd.set(qn("w:color"), "auto")
+    shd.set(qn("w:fill"), fill_color)
+    pPr.append(shd)
+
+
+def set_paragraph_borders(paragraph, color="CCCCCC", size="4", space="4"):
+    """Add borders around a paragraph."""
+    pPr = paragraph._element.get_or_add_pPr()
+    pBdr = OxmlElement("w:pBdr")
+    for side in ("top", "left", "bottom", "right"):
+        border = OxmlElement(f"w:{side}")
+        border.set(qn("w:val"), "single")
+        border.set(qn("w:sz"), size)
+        border.set(qn("w:space"), space)
+        border.set(qn("w:color"), color)
+        pBdr.append(border)
+    pPr.append(pBdr)
+
+
+def set_run_shading(run, fill_color):
+    """Set background highlight for a run (inline code)."""
+    rPr = run._element.get_or_add_rPr()
+    shd = OxmlElement("w:shd")
+    shd.set(qn("w:val"), "clear")
+    shd.set(qn("w:color"), "auto")
+    shd.set(qn("w:fill"), fill_color)
+    rPr.append(shd)
+
+
+def set_blockquote_style(paragraph, depth=1):
+    """Style a paragraph as a blockquote with left border."""
+    paragraph.paragraph_format.left_indent = Inches(0.4 * depth)
+    pPr = paragraph._element.get_or_add_pPr()
+    pBdr = OxmlElement("w:pBdr")
+    left = OxmlElement("w:left")
+    left.set(qn("w:val"), "single")
+    left.set(qn("w:sz"), "18")
+    left.set(qn("w:space"), "8")
+    left.set(qn("w:color"), COLOR_BLOCKQUOTE_BORDER)
+    pBdr.append(left)
+    pPr.append(pBdr)
+
+
+def add_horizontal_rule(doc):
+    """Add a horizontal rule to the document."""
+    p = doc.add_paragraph()
+    p.paragraph_format.space_before = Pt(8)
+    p.paragraph_format.space_after = Pt(8)
+    pPr = p._element.get_or_add_pPr()
+    pBdr = OxmlElement("w:pBdr")
+    bottom = OxmlElement("w:bottom")
+    bottom.set(qn("w:val"), "single")
+    bottom.set(qn("w:sz"), "12")
+    bottom.set(qn("w:space"), "1")
+    bottom.set(qn("w:color"), COLOR_HR)
+    pBdr.append(bottom)
+    pPr.append(pBdr)
+
+
+def set_table_header_shading(cell, fill_color=COLOR_TABLE_HEADER_BG):
+    """Set background color for a table header cell."""
+    tcPr = cell._element.get_or_add_tcPr()
+    shd = OxmlElement("w:shd")
+    shd.set(qn("w:val"), "clear")
+    shd.set(qn("w:color"), "auto")
+    shd.set(qn("w:fill"), fill_color)
+    tcPr.append(shd)
+
+
+def setup_document_styles(doc):
+    """Configure the document with standard page setup and styles."""
+    # Page margins
+    for section in doc.sections:
+        section.top_margin = PAGE_MARGIN_TOP
+        section.bottom_margin = PAGE_MARGIN_BOTTOM
+        section.left_margin = PAGE_MARGIN_LEFT
+        section.right_margin = PAGE_MARGIN_RIGHT
+
+    # Default paragraph style
+    style = doc.styles["Normal"]
+    font = style.font
+    font.name = FONT_BODY
+    font.size = FONT_SIZE_BODY
+    font.color.rgb = COLOR_BODY_TEXT
+    pf = style.paragraph_format
+    pf.space_before = PARA_SPACE_BEFORE
+    pf.space_after = PARA_SPACE_AFTER
+    pf.line_spacing = LINE_SPACING
+
+    # Set East Asian font for Normal style
+    rPr = style._element.get_or_add_rPr()
+    rFonts = rPr.find(qn("w:rFonts"))
+    if rFonts is None:
+        rFonts = OxmlElement("w:rFonts")
+        rPr.insert(0, rFonts)
+    rFonts.set(qn("w:eastAsia"), FONT_BODY)
+
+    # Heading styles
+    for level in range(1, 7):
+        style_name = f"Heading {level}"
+        if style_name in doc.styles:
+            h_style = doc.styles[style_name]
+            h_font = h_style.font
+            h_font.name = FONT_HEADING
+            h_font.size = HEADING_SIZES.get(level, Pt(11))
+            h_font.color.rgb = HEADING_COLORS.get(level, COLOR_BODY_TEXT)
+            h_font.bold = True
+            h_pf = h_style.paragraph_format
+            h_pf.space_before = HEADING_SPACE_BEFORE
+            h_pf.space_after = HEADING_SPACE_AFTER
+            h_pf.keep_with_next = True
+
+            # East Asian font
+            h_rPr = h_style._element.get_or_add_rPr()
+            h_rFonts = h_rPr.find(qn("w:rFonts"))
+            if h_rFonts is None:
+                h_rFonts = OxmlElement("w:rFonts")
+                h_rPr.insert(0, h_rFonts)
+            h_rFonts.set(qn("w:eastAsia"), FONT_HEADING)

markdocx-0.1.0.dist-info/METADATA

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: markdocx
+Version: 0.1.0
+Summary: Convert AI-generated Markdown textbooks to polished DOCX with native math equations and syntax-highlighted code
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.14
+Requires-Dist: latex2mathml==3.78.1
+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: pillow==12.1.0
+Requires-Dist: pygments==2.19.2
+Requires-Dist: python-docx==1.2.0
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# MD to DOCX
+
+**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.
+
+[![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)
+
+</div>
+
+---
+
+## Why This Exists
+
+Large language models (ChatGPT, Claude, Gemini, …) produce great Markdown, but the journey from `.md` to a well-formatted **Word document** is painful:
+
+- LaTeX formulas become plain text or broken images
+- 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.
+
+## Features
+
+| Category | What you get |
+|:---------|:-------------|
+| **Math** | Inline (`$...$`) and display (`$$...$$`) LaTeX → native OMML equations in Word |
+| **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 |
+| **Other** | Blockquotes, horizontal rules, clickable hyperlinks, local images, footnotes |
+
+## Quick Start
+
+### Installation
+
+```bash
+git clone https://github.com/<your-username>/md_to_docx.git
+cd md_to_docx
+
+# Using uv (recommended)
+uv sync
+
+# Or using pip
+pip install -r requirements.txt
+```
+
+### Usage
+
+```bash
+# Convert a single file
+python main.py input.md
+python main.py input.md -o output.docx
+
+# Convert an entire directory
+python main.py ./chapters/ -o ./output/
+
+# Recursively search subdirectories
+python main.py ./chapters/ -o ./output/ -r
+
+# Verbose logging
+python main.py input.md -v
+```
+
+### CLI Options
+
+| Flag | Description |
+|:-----|:------------|
+| `input` | Markdown file or directory to convert |
+| `-o, --output` | Output file or directory path |
+| `-r, --recursive` | Recursively find `.md` files in subdirectories |
+| `-v, --verbose` | Show detailed processing logs |
+
+## How It Works
+
+```
+Markdown file
+     │
+     ▼
+ md_parser.py        ─── markdown-it-py tokenizer
+     │
+     ▼
+ 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
+     │
+     ▼
+  .docx file          ─── python-docx output
+```
+
+### Math Pipeline
+
+LaTeX is converted to **native OMML** (Office Math Markup Language), not images. This means formulas are editable, scale perfectly, and look like they were typed in Word's equation editor.
+
+```
+LaTeX string → latex2mathml → MathML → XSLT → OMML → Word paragraph
+```
+
+### Code Pipeline
+
+```
+Source code → Pygments lexer + VS Code theme → colored Word runs inside a shaded table cell
+```
+
+## Project Structure
+
+```
+md_to_docx/
+├── main.py                  # CLI 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
+└── rule/
+    ├── ai_gen_doc_rule.md      # AI writing rules (Vietnamese)
+    └── ai_gen_doc_rule_en.md   # AI writing rules (English)
+```
+
+## Dependencies
+
+| Package | Version | Role |
+|:--------|:--------|:-----|
+| [python-docx](https://python-docx.readthedocs.io/) | 1.2.0 | DOCX generation |
+| [markdown-it-py](https://github.com/executablebooks/markdown-it-py) | 4.0.0 | Markdown parsing |
+| [mdit-py-plugins](https://github.com/executablebooks/mdit-py-plugins) | 0.5.0 | Math & footnote plugins |
+| [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) |
+| [Pillow](https://python-pillow.org/) | 12.1.0 | Image processing |
+
+## AI Writing Rules
+
+The `rule/` directory contains detailed guidelines for prompting AI models to produce Markdown that converts cleanly:
+
+| File | Language | Description |
+|:-----|:---------|:------------|
+| `rule/ai_gen_doc_rule.md` | Vietnamese | Full rule set — heading structure, LaTeX constraints, code block format, tables, etc. |
+| `rule/ai_gen_doc_rule_en.md` | English | Same rules, English version |
+
+**How to use:** Paste the contents of the appropriate rule file into your AI system prompt (or at the start of the conversation) before asking it to write textbook content.
+
+## Contributing
+
+Contributions are welcome. Please open an issue first to discuss what you'd like to change.
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.

markdocx-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+markdocx/__init__.py,sha256=W3f27F3zCfAPH1b-ClQshSOETF_HOMJmEPl1Z82C_xo,269
+markdocx/cli.py,sha256=8Z2ImBMOlfPvqs88qrKjHc5qicF3mj8mo7ya86ZYku4,3615
+markdocx/code_renderer.py,sha256=u4fD_oeHu6XWG_VDWQNUCErTavL_sbVfY8iKSeb5hsY,4643
+markdocx/core.py,sha256=9zKaj8HYsXp2mUED1pI-MMWpUJ8c5MOsBW3dJuzIFoc,3831
+markdocx/docx_builder.py,sha256=2O9zn3hvTxHxVT_PJgvmk42ju3E4cp7tqyryVEzJ95M,28842
+markdocx/math_renderer.py,sha256=-rlzc6scwDcpnROKQ-yLBVOnlyMQbJlbegYykdCKyaM,16830
+markdocx/md_parser.py,sha256=itYFmkIQ7kAnAKYfUAE7b5osIEJ1wFX1yZmMCJbV--0,1372
+markdocx/styles.py,sha256=s2LP3h18WyHH7Fw8J7T7IQIED543AYav5u8sfUoesEA,9809
+markdocx-0.1.0.dist-info/METADATA,sha256=aLw-AofOVZGVCzxgKNCL4TQTpFz5sTTAQ_KJ1idJfTU,6533
+markdocx-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+markdocx-0.1.0.dist-info/entry_points.txt,sha256=OwL_Kigr4PsJyDVXFzVE9TooU1bN7DyAil8Il0l1P1I,47
+markdocx-0.1.0.dist-info/licenses/LICENSE,sha256=gECgcvYlt5qm4TtDOUfhWot49Ki-0PJUe23z1BIZC4c,1065
+markdocx-0.1.0.dist-info/RECORD,,

markdocx-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

markdocx-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+markdocx = markdocx.cli:main

markdocx-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +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.