markdown-pdf-converter 1.0.0__tar.gz

markdown_pdf_converter-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 markdown-pdf-converter
+
+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.

markdown_pdf_converter-1.0.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include MANIFEST.in
+recursive-include examples *.md *.py
+recursive-include tests *.py

markdown_pdf_converter-1.0.0/PKG-INFO

@@ -0,0 +1,241 @@
+Metadata-Version: 2.4
+Name: markdown-pdf-converter
+Version: 1.0.0
+Summary: A Python library to convert Markdown files to PDF with Chinese support
+Author-email: louischerry <louischerry@126.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/markdown-pdf-converter
+Project-URL: Documentation, https://github.com/yourusername/markdown-pdf-converter#readme
+Project-URL: Repository, https://github.com/yourusername/markdown-pdf-converter
+Project-URL: Issues, https://github.com/yourusername/markdown-pdf-converter/issues
+Keywords: markdown,pdf,converter,chinese,reportlab
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup
+Classifier: Topic :: Utilities
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: reportlab>=3.6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+# Markdown PDF Converter
+
+[![PyPI version](https://badge.fury.io/py/markdown-pdf-converter.svg)](https://badge.fury.io/py/markdown-pdf-converter)
+[![Python version](https://img.shields.io/pypi/pyversions/markdown-pdf-converter.svg)](https://pypi.org/project/markdown-pdf-converter/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+A Python library to convert Markdown files to PDF with **Chinese support** and **intelligent code wrapping**.
+
+## ✨ Features
+
+- 📝 **Markdown to PDF**: Convert Markdown files to beautifully formatted PDF documents
+- 🇨🇳 **Chinese Support**: Automatic Chinese font detection and rendering
+- 💻 **Code Block Handling**: Smart formatting for code blocks with proper line wrapping
+- 🎨 **Customizable Styles**: Multiple style presets (default, compact, large print)
+- 🔧 **Flexible Configuration**: Customize fonts, margins, font sizes, and colors
+- 🚀 **Command Line Interface**: Easy-to-use CLI for quick conversions
+- 📦 **Pure Python**: No external dependencies except reportlab
+
+## 📦 Installation
+
+```bash
+pip install markdown-pdf-converter
+```
+
+### Development Installation
+
+```bash
+git clone https://github.com/yourusername/markdown-pdf-converter.git
+cd markdown-pdf-converter
+pip install -e ".[dev]"
+```
+
+## 🚀 Quick Start
+
+### Command Line Usage
+
+```bash
+# Basic conversion
+md2pdf input.md
+
+# Specify output file
+md2pdf input.md -o output.pdf
+
+# Use compact style for dense content
+md2pdf input.md --style compact
+
+# Use custom font
+md2pdf input.md --font /path/to/chinese/font.ttf
+
+# Customize font sizes and margins
+md2pdf input.md --title-size 18 --body-size 10 --margin 2.5
+```
+
+### Python API Usage
+
+```python
+from markdown_pdf_converter import MarkdownToPDFConverter
+from markdown_pdf_converter.styles import PDFStyles
+
+# Basic usage
+converter = MarkdownToPDFConverter()
+converter.convert("input.md", "output.pdf")
+
+# With custom font
+converter = MarkdownToPDFConverter(font_path="/path/to/font.ttf")
+converter.convert("input.md", "output.pdf")
+
+# With custom styles
+styles = PDFStyles(
+    title_font_size=20,
+    body_font_size=11,
+    right_margin=2.5,
+    left_margin=2.5
+)
+converter = MarkdownToPDFConverter()
+converter.convert("input.md", "output.pdf", **styles.to_dict())
+
+# Use preset styles
+converter = MarkdownToPDFConverter()
+converter.convert("input.md", "output.pdf", **PDFStyles.compact().to_dict())
+```
+
+## 📖 Supported Markdown Features
+
+- ✅ Headers (H1, H2, H3)
+- ✅ Bold and italic text
+- ✅ Lists (ordered and unordered)
+- ✅ Code blocks and inline code
+- ✅ Blockquotes
+- ✅ Links
+- ✅ Horizontal rules
+- ✅ Tables (simplified)
+
+## 🎨 Style Presets
+
+### Default Style
+Standard formatting suitable for most documents.
+
+```python
+from markdown_pdf_converter.styles import PDFStyles
+styles = PDFStyles.default()
+```
+
+### Compact Style
+Optimized for dense content like technical documentation.
+
+```python
+from markdown_pdf_converter.styles import PDFStyles
+styles = PDFStyles.compact()
+```
+
+### Large Print Style
+Enhanced readability with larger fonts.
+
+```python
+from markdown_pdf_converter.styles import PDFStyles
+styles = PDFStyles.large_print()
+```
+
+## 🔧 Configuration Options
+
+### PDFStyles Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `page_size` | str | "A4" | Page size (A4, Letter, Legal) |
+| `right_margin` | float | 2.0 | Right margin in cm |
+| `left_margin` | float | 2.0 | Left margin in cm |
+| `top_margin` | float | 2.0 | Top margin in cm |
+| `bottom_margin` | float | 2.0 | Bottom margin in cm |
+| `title_font_size` | int | 16 | H1 font size |
+| `heading_font_size` | int | 13 | H2 font size |
+| `subheading_font_size` | int | 11 | H3 font size |
+| `body_font_size` | int | 9 | Body text font size |
+| `code_font_size` | int | 8 | Code block font size |
+
+## 🌐 Chinese Font Support
+
+The library automatically detects and uses Chinese fonts from common system locations:
+
+- **macOS**: PingFang, STHeiti, Hiragino Sans GB
+- **Linux**: WQY Zenhei, WQY Microhei, Noto Sans CJK
+- **Windows**: SimSun, Microsoft YaHei (add your font path manually)
+
+### Custom Font
+
+If automatic detection fails, specify a font path:
+
+```python
+converter = MarkdownToPDFConverter(font_path="/path/to/your/font.ttf")
+```
+
+## 🧪 Testing
+
+```bash
+# Run tests
+pytest
+
+# Run tests with coverage
+pytest --cov=markdown_pdf_converter
+
+# Run linting
+black markdown_pdf_converter/
+flake8 markdown_pdf_converter/
+```
+
+## 📁 Project Structure
+
+```
+markdown-pdf-converter/
+├── markdown_pdf_converter/     # Main package
+│   ├── __init__.py
+│   ├── converter.py           # Core conversion logic
+│   ├── styles.py              # Style configuration
+│   └── cli.py                 # Command line interface
+├── tests/                      # Test files
+├── examples/                   # Example files
+├── pyproject.toml             # Package configuration
+├── README.md                  # This file
+└── LICENSE                    # MIT License
+```
+
+## 🤝 Contributing
+
+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.
+
+## 🐛 Issues
+
+If you encounter any issues or have suggestions, please [open an issue](https://github.com/yourusername/markdown-pdf-converter/issues).
+
+## 🙏 Acknowledgments
+
+- Built with [ReportLab](https://www.reportlab.com/) - PDF generation library
+- Inspired by the need for simple Markdown to PDF conversion with Chinese support
+
+---
+
+**Happy Converting!** 🎉

markdown_pdf_converter-1.0.0/README.md

@@ -0,0 +1,206 @@
+# Markdown PDF Converter
+
+[![PyPI version](https://badge.fury.io/py/markdown-pdf-converter.svg)](https://badge.fury.io/py/markdown-pdf-converter)
+[![Python version](https://img.shields.io/pypi/pyversions/markdown-pdf-converter.svg)](https://pypi.org/project/markdown-pdf-converter/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+A Python library to convert Markdown files to PDF with **Chinese support** and **intelligent code wrapping**.
+
+## ✨ Features
+
+- 📝 **Markdown to PDF**: Convert Markdown files to beautifully formatted PDF documents
+- 🇨🇳 **Chinese Support**: Automatic Chinese font detection and rendering
+- 💻 **Code Block Handling**: Smart formatting for code blocks with proper line wrapping
+- 🎨 **Customizable Styles**: Multiple style presets (default, compact, large print)
+- 🔧 **Flexible Configuration**: Customize fonts, margins, font sizes, and colors
+- 🚀 **Command Line Interface**: Easy-to-use CLI for quick conversions
+- 📦 **Pure Python**: No external dependencies except reportlab
+
+## 📦 Installation
+
+```bash
+pip install markdown-pdf-converter
+```
+
+### Development Installation
+
+```bash
+git clone https://github.com/yourusername/markdown-pdf-converter.git
+cd markdown-pdf-converter
+pip install -e ".[dev]"
+```
+
+## 🚀 Quick Start
+
+### Command Line Usage
+
+```bash
+# Basic conversion
+md2pdf input.md
+
+# Specify output file
+md2pdf input.md -o output.pdf
+
+# Use compact style for dense content
+md2pdf input.md --style compact
+
+# Use custom font
+md2pdf input.md --font /path/to/chinese/font.ttf
+
+# Customize font sizes and margins
+md2pdf input.md --title-size 18 --body-size 10 --margin 2.5
+```
+
+### Python API Usage
+
+```python
+from markdown_pdf_converter import MarkdownToPDFConverter
+from markdown_pdf_converter.styles import PDFStyles
+
+# Basic usage
+converter = MarkdownToPDFConverter()
+converter.convert("input.md", "output.pdf")
+
+# With custom font
+converter = MarkdownToPDFConverter(font_path="/path/to/font.ttf")
+converter.convert("input.md", "output.pdf")
+
+# With custom styles
+styles = PDFStyles(
+    title_font_size=20,
+    body_font_size=11,
+    right_margin=2.5,
+    left_margin=2.5
+)
+converter = MarkdownToPDFConverter()
+converter.convert("input.md", "output.pdf", **styles.to_dict())
+
+# Use preset styles
+converter = MarkdownToPDFConverter()
+converter.convert("input.md", "output.pdf", **PDFStyles.compact().to_dict())
+```
+
+## 📖 Supported Markdown Features
+
+- ✅ Headers (H1, H2, H3)
+- ✅ Bold and italic text
+- ✅ Lists (ordered and unordered)
+- ✅ Code blocks and inline code
+- ✅ Blockquotes
+- ✅ Links
+- ✅ Horizontal rules
+- ✅ Tables (simplified)
+
+## 🎨 Style Presets
+
+### Default Style
+Standard formatting suitable for most documents.
+
+```python
+from markdown_pdf_converter.styles import PDFStyles
+styles = PDFStyles.default()
+```
+
+### Compact Style
+Optimized for dense content like technical documentation.
+
+```python
+from markdown_pdf_converter.styles import PDFStyles
+styles = PDFStyles.compact()
+```
+
+### Large Print Style
+Enhanced readability with larger fonts.
+
+```python
+from markdown_pdf_converter.styles import PDFStyles
+styles = PDFStyles.large_print()
+```
+
+## 🔧 Configuration Options
+
+### PDFStyles Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `page_size` | str | "A4" | Page size (A4, Letter, Legal) |
+| `right_margin` | float | 2.0 | Right margin in cm |
+| `left_margin` | float | 2.0 | Left margin in cm |
+| `top_margin` | float | 2.0 | Top margin in cm |
+| `bottom_margin` | float | 2.0 | Bottom margin in cm |
+| `title_font_size` | int | 16 | H1 font size |
+| `heading_font_size` | int | 13 | H2 font size |
+| `subheading_font_size` | int | 11 | H3 font size |
+| `body_font_size` | int | 9 | Body text font size |
+| `code_font_size` | int | 8 | Code block font size |
+
+## 🌐 Chinese Font Support
+
+The library automatically detects and uses Chinese fonts from common system locations:
+
+- **macOS**: PingFang, STHeiti, Hiragino Sans GB
+- **Linux**: WQY Zenhei, WQY Microhei, Noto Sans CJK
+- **Windows**: SimSun, Microsoft YaHei (add your font path manually)
+
+### Custom Font
+
+If automatic detection fails, specify a font path:
+
+```python
+converter = MarkdownToPDFConverter(font_path="/path/to/your/font.ttf")
+```
+
+## 🧪 Testing
+
+```bash
+# Run tests
+pytest
+
+# Run tests with coverage
+pytest --cov=markdown_pdf_converter
+
+# Run linting
+black markdown_pdf_converter/
+flake8 markdown_pdf_converter/
+```
+
+## 📁 Project Structure
+
+```
+markdown-pdf-converter/
+├── markdown_pdf_converter/     # Main package
+│   ├── __init__.py
+│   ├── converter.py           # Core conversion logic
+│   ├── styles.py              # Style configuration
+│   └── cli.py                 # Command line interface
+├── tests/                      # Test files
+├── examples/                   # Example files
+├── pyproject.toml             # Package configuration
+├── README.md                  # This file
+└── LICENSE                    # MIT License
+```
+
+## 🤝 Contributing
+
+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.
+
+## 🐛 Issues
+
+If you encounter any issues or have suggestions, please [open an issue](https://github.com/yourusername/markdown-pdf-converter/issues).
+
+## 🙏 Acknowledgments
+
+- Built with [ReportLab](https://www.reportlab.com/) - PDF generation library
+- Inspired by the need for simple Markdown to PDF conversion with Chinese support
+
+---
+
+**Happy Converting!** 🎉

markdown_pdf_converter-1.0.0/examples/convert_example.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+"""
+Example usage of markdown-pdf-converter
+"""
+
+import os
+from markdown_pdf_converter import MarkdownToPDFConverter
+from markdown_pdf_converter.styles import PDFStyles
+
+
+def basic_conversion():
+    """Basic conversion example"""
+    converter = MarkdownToPDFConverter()
+    
+    # Get the directory of this script
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    input_file = os.path.join(script_dir, "example.md")
+    output_file = os.path.join(script_dir, "example_basic.pdf")
+    
+    converter.convert(input_file, output_file)
+    print(f"✓ Basic conversion complete: {output_file}")
+
+
+def compact_style_conversion():
+    """Compact style conversion example"""
+    converter = MarkdownToPDFConverter()
+    
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    input_file = os.path.join(script_dir, "example.md")
+    output_file = os.path.join(script_dir, "example_compact.pdf")
+    
+    # Use compact style
+    styles = PDFStyles.compact()
+    converter.convert(input_file, output_file, **styles.to_dict())
+    print(f"✓ Compact style conversion complete: {output_file}")
+
+
+def large_print_conversion():
+    """Large print style conversion example"""
+    converter = MarkdownToPDFConverter()
+    
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    input_file = os.path.join(script_dir, "example.md")
+    output_file = os.path.join(script_dir, "example_large.pdf")
+    
+    # Use large print style
+    styles = PDFStyles.large_print()
+    converter.convert(input_file, output_file, **styles.to_dict())
+    print(f"✓ Large print conversion complete: {output_file}")
+
+
+def custom_style_conversion():
+    """Custom style conversion example"""
+    converter = MarkdownToPDFConverter()
+    
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    input_file = os.path.join(script_dir, "example.md")
+    output_file = os.path.join(script_dir, "example_custom.pdf")
+    
+    # Create custom styles
+    styles = PDFStyles(
+        title_font_size=20,
+        heading_font_size=16,
+        body_font_size=11,
+        code_font_size=9,
+        right_margin=2.5,
+        left_margin=2.5,
+        top_margin=2.5,
+        bottom_margin=2.5
+    )
+    
+    converter.convert(input_file, output_file, **styles.to_dict())
+    print(f"✓ Custom style conversion complete: {output_file}")
+
+
+if __name__ == "__main__":
+    print("Running Markdown to PDF Converter Examples...\n")
+    
+    basic_conversion()
+    compact_style_conversion()
+    large_print_conversion()
+    custom_style_conversion()
+    
+    print("\n✓ All examples completed!")

markdown_pdf_converter-1.0.0/examples/example.md

@@ -0,0 +1,77 @@
+# Markdown PDF Converter Example
+
+This is an example Markdown file to demonstrate the conversion capabilities.
+
+## Features
+
+### Text Formatting
+
+**Bold text** and *italic text* are supported.
+
+### Lists
+
+Unordered list:
+- Item 1
+- Item 2
+- Item 3
+
+Ordered list:
+1. First item
+2. Second item
+3. Third item
+
+### Code Blocks
+
+```python
+def hello_world():
+    print("Hello, World!")
+    return True
+```
+
+```java
+public class HelloWorld {
+    public static void main(String[] args) {
+        System.out.println("Hello, World!");
+    }
+}
+```
+
+### Links
+
+Visit [GitHub](https://github.com) for more information.
+
+### Blockquotes
+
+> This is a blockquote.
+> It can span multiple lines.
+
+### Tables
+
+| Feature | Supported |
+|---------|-----------|
+| Headers | Yes |
+| Lists | Yes |
+| Code | Yes |
+
+---
+
+## Chinese Support Test
+
+这是一个中文测试段落。
+
+### 中文列表演示
+
+- 第一项
+- 第二项
+- 第三项
+
+### 中文代码示例
+
+```python
+# 中文注释示例
+def  greet(name):
+    print(f"你好，{name}！")
+    return True
+```
+
+**结束**

markdown_pdf_converter-1.0.0/markdown_pdf_converter/__init__.py

@@ -0,0 +1,14 @@
+"""
+Markdown to PDF Converter
+
+A Python library to convert Markdown files to PDF with Chinese support.
+"""
+
+from .converter import MarkdownToPDFConverter
+from .styles import PDFStyles
+
+__version__ = "1.0.0"
+__author__ = "Your Name"
+__email__ = "your.email@example.com"
+
+__all__ = ["MarkdownToPDFConverter", "PDFStyles"]