markconv 0.1.0__tar.gz

markconv-0.1.0/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: markconv
+Version: 0.1.0
+Summary: 一个强大的 Markdown 转换工具库
+Home-page: https://github.com/Zheng-Enci/markconv
+Author: Zheng EnCi
+Author-email: zheng_enci@qq.com
+Project-URL: Bug Reports, https://github.com/Zheng-Enci/markconv/issues
+Project-URL: Source, https://github.com/Zheng-Enci/markconv
+Project-URL: Documentation, https://github.com/Zheng-Enci/markconv/blob/master/README.md
+Keywords: markdown html converter
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: markdown2>=2.5.5
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# markconv
+
+一个强大的 Markdown 转换工具库。
+
+**版本**: v0.1.0
+
+## 背景
+
+在日常开发中，我们经常需要将 Markdown 文档转换为其他格式（如 HTML、PDF、DOCX 等），但现有的解决方案存在诸多痛点：
+
+- **配置繁琐**：许多库需要复杂的配置和依赖管理，学习成本高
+- **中文支持差**：部分工具对中文显示支持不佳，需要额外配置字体和编码
+- **样式定制困难**：自定义样式需要深入了解工具的内部机制
+- **收费限制**：一些在线工具和商业软件需要付费，功能受限
+- **依赖繁重**：某些库依赖过多，安装和使用都不够轻量
+
+为了解决这些问题，我开发了 **markconv** —— 一个简单、高效、免费的 Markdown 转换工具库。
+
+## 简介
+
+markconv 是一个 Python 库，旨在提供简单易用的 Markdown 转换功能。该库支持将 Markdown 文档转换为多种格式，方便用户在不同场景下使用。
+
+**当前版本支持**：
+- Markdown → HTML
+
+**计划支持**：
+- Markdown → PDF
+- Markdown → DOCX
+- 更多格式...
+
+## 项目地址
+
+- **Gitee**: https://gitee.com/zheng-enci050704/markconv
+- **GitHub**: https://github.com/Zheng-Enci/markconv
+- **GitCode**: https://gitcode.com/ZhengEnCi/markconv
+
+## 功能特性
+
+- 📝 **简单易用**：提供简洁的 API 接口
+- 🚀 **高性能**：基于高效的转换引擎
+- 🔧 **可扩展**：支持自定义转换器和插件
+- 📦 **轻量级**：最小化依赖，易于集成
+- 🎨 **样式灵活**：支持自定义 CSS 样式
+- 🌐 **中文友好**：内置中文字体支持，UTF-8 编码
+
+## 安装
+
+### 从源码安装
+
+```bash
+# 选择一个源进行克隆
+git clone https://github.com/Zheng-Enci/markconv.git
+# 或
+git clone https://gitee.com/zheng-enci050704/markconv.git
+# 或
+git clone https://gitcode.com/ZhengEnCi/markconv.git
+
+# 安装依赖
+cd markconv
+pip install -r requirements.txt
+```
+
+### 使用安装脚本（推荐国内用户）
+
+项目提供了一个安装脚本，使用清华源加速依赖下载：
+
+```bash
+cd markconv
+python installl_requirements.py
+```
+
+该脚本会自动从清华源安装 `requirements.txt` 中的所有依赖项，速度更快。
+
+### 依赖项
+
+- Python 3.13+
+
+## 快速开始
+
+查看 `examples/` 目录获取完整示例。
+
+## 开发计划
+
+- [x] 实现 Markdown 到 HTML 的转换
+- [x] 支持自定义 CSS 样式
+- [x] 支持中文显示
+- [x] 自动创建输出目录
+- [ ] 添加更多代码高亮主题
+- [ ] 支持自定义主题模板
+- [ ] 添加命令行工具
+- [ ] 完善单元测试
+- [ ] 发布到 PyPI
+
+## 项目结构
+
+```
+markconv/
+├── markconv/                         # 主包目录
+│   ├── __init__.py                 # 包初始化文件 (v0.1.0)
+│   ├── html_converter.py           # HTML转换器核心模块
+│   ├── parsers/                    # 解析器模块
+│   │   ├── __init__.py
+│   │   └── markdown_parser.py      # Markdown解析器
+│   └── exporters/                  # 导出器模块
+│       ├── __init__.py
+│       └── html_exporter.py        # HTML导出器
+├── examples/                       # 示例代码
+│   └── html_example/
+│       ├── html_example.py         # HTML转换示例
+│       ├── sample.md               # 示例Markdown文件
+│       ├── custom.css              # 自定义CSS样式
+│       └── examples/
+│           └── sample.html         # 生成的HTML文件
+├── Note/                           # 笔记目录
+│   └── Update_logs/               # 更新日志
+├── README.md                       # 项目说明文档
+├── requirements.txt                # 依赖列表
+└── installl_requirements.py        # 安装脚本
+```
+
+## 贡献指南
+
+欢迎贡献代码！请遵循以下步骤：
+
+1. Fork 本项目
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 开启 Pull Request
+
+## 许可证
+
+MIT License
+
+## 致谢
+
+感谢所有为本项目做出贡献的开发者！
+
+---
+
+**注意**：本项目正在积极开发中，API 可能会有变化。建议关注版本更新日志。

markconv-0.1.0/README.md

@@ -0,0 +1,141 @@
+# markconv
+
+一个强大的 Markdown 转换工具库。
+
+**版本**: v0.1.0
+
+## 背景
+
+在日常开发中，我们经常需要将 Markdown 文档转换为其他格式（如 HTML、PDF、DOCX 等），但现有的解决方案存在诸多痛点：
+
+- **配置繁琐**：许多库需要复杂的配置和依赖管理，学习成本高
+- **中文支持差**：部分工具对中文显示支持不佳，需要额外配置字体和编码
+- **样式定制困难**：自定义样式需要深入了解工具的内部机制
+- **收费限制**：一些在线工具和商业软件需要付费，功能受限
+- **依赖繁重**：某些库依赖过多，安装和使用都不够轻量
+
+为了解决这些问题，我开发了 **markconv** —— 一个简单、高效、免费的 Markdown 转换工具库。
+
+## 简介
+
+markconv 是一个 Python 库，旨在提供简单易用的 Markdown 转换功能。该库支持将 Markdown 文档转换为多种格式，方便用户在不同场景下使用。
+
+**当前版本支持**：
+- Markdown → HTML
+
+**计划支持**：
+- Markdown → PDF
+- Markdown → DOCX
+- 更多格式...
+
+## 项目地址
+
+- **Gitee**: https://gitee.com/zheng-enci050704/markconv
+- **GitHub**: https://github.com/Zheng-Enci/markconv
+- **GitCode**: https://gitcode.com/ZhengEnCi/markconv
+
+## 功能特性
+
+- 📝 **简单易用**：提供简洁的 API 接口
+- 🚀 **高性能**：基于高效的转换引擎
+- 🔧 **可扩展**：支持自定义转换器和插件
+- 📦 **轻量级**：最小化依赖，易于集成
+- 🎨 **样式灵活**：支持自定义 CSS 样式
+- 🌐 **中文友好**：内置中文字体支持，UTF-8 编码
+
+## 安装
+
+### 从源码安装
+
+```bash
+# 选择一个源进行克隆
+git clone https://github.com/Zheng-Enci/markconv.git
+# 或
+git clone https://gitee.com/zheng-enci050704/markconv.git
+# 或
+git clone https://gitcode.com/ZhengEnCi/markconv.git
+
+# 安装依赖
+cd markconv
+pip install -r requirements.txt
+```
+
+### 使用安装脚本（推荐国内用户）
+
+项目提供了一个安装脚本，使用清华源加速依赖下载：
+
+```bash
+cd markconv
+python installl_requirements.py
+```
+
+该脚本会自动从清华源安装 `requirements.txt` 中的所有依赖项，速度更快。
+
+### 依赖项
+
+- Python 3.13+
+
+## 快速开始
+
+查看 `examples/` 目录获取完整示例。
+
+## 开发计划
+
+- [x] 实现 Markdown 到 HTML 的转换
+- [x] 支持自定义 CSS 样式
+- [x] 支持中文显示
+- [x] 自动创建输出目录
+- [ ] 添加更多代码高亮主题
+- [ ] 支持自定义主题模板
+- [ ] 添加命令行工具
+- [ ] 完善单元测试
+- [ ] 发布到 PyPI
+
+## 项目结构
+
+```
+markconv/
+├── markconv/                         # 主包目录
+│   ├── __init__.py                 # 包初始化文件 (v0.1.0)
+│   ├── html_converter.py           # HTML转换器核心模块
+│   ├── parsers/                    # 解析器模块
+│   │   ├── __init__.py
+│   │   └── markdown_parser.py      # Markdown解析器
+│   └── exporters/                  # 导出器模块
+│       ├── __init__.py
+│       └── html_exporter.py        # HTML导出器
+├── examples/                       # 示例代码
+│   └── html_example/
+│       ├── html_example.py         # HTML转换示例
+│       ├── sample.md               # 示例Markdown文件
+│       ├── custom.css              # 自定义CSS样式
+│       └── examples/
+│           └── sample.html         # 生成的HTML文件
+├── Note/                           # 笔记目录
+│   └── Update_logs/               # 更新日志
+├── README.md                       # 项目说明文档
+├── requirements.txt                # 依赖列表
+└── installl_requirements.py        # 安装脚本
+```
+
+## 贡献指南
+
+欢迎贡献代码！请遵循以下步骤：
+
+1. Fork 本项目
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 开启 Pull Request
+
+## 许可证
+
+MIT License
+
+## 致谢
+
+感谢所有为本项目做出贡献的开发者！
+
+---
+
+**注意**：本项目正在积极开发中，API 可能会有变化。建议关注版本更新日志。

markconv-0.1.0/markconv/__init__.py

@@ -0,0 +1,21 @@
+"""
+mdtool - Markdown 转换工具库
+
+一个强大的 Python 库，用于将 Markdown 文件转换为 HTML 格式。
+
+主要功能：
+- Markdown 到 HTML 的转换
+- 批量文件转换
+- 自定义样式支持
+- 中文友好
+
+Example:
+    >>> from mdtool import MDConverter
+    >>> converter = MDConverter()
+    >>> converter.to_html('input.md', 'output.html')
+"""
+
+from .html_converter import MDConverter
+
+__version__ = '0.1.0'
+__all__ = ['MDConverter']

markconv-0.1.0/markconv/exporters/__init__.py

@@ -0,0 +1,9 @@
+"""
+导出器模块
+
+提供将解析后的 Markdown 数据导出为各种格式的功能
+"""
+
+from .html_exporter import HTMLExporter
+
+__all__ = ['HTMLExporter']

markconv-0.1.0/markconv/exporters/html_exporter.py

@@ -0,0 +1,229 @@
+import os
+from typing import Dict, Any
+import markdown2
+
+
+def _markdown_to_html(markdown_content: str) -> str:
+    """
+    将 Markdown 内容转换为 HTML
+
+    使用 markdown2 库进行转换，启用多种扩展功能
+
+    Args:
+        markdown_content (str): Markdown 格式的内容字符串
+
+    Returns:
+        str: 转换后的 HTML 内容
+
+    Note:
+        启用的扩展功能包括：
+        - fenced-code-blocks: 围栏代码块
+        - tables: 表格支持
+        - toc: 目录生成
+        - code-friendly: 代码友好模式
+        - footnotes: 脚注
+        - strike: 删除线
+        - task_list: 任务列表
+    """
+    extras = [
+        'fenced-code-blocks',
+        'tables',
+        'toc',
+        'code-friendly',
+        'footnotes',
+        'strike',
+        'task_list'
+    ]
+    return markdown2.markdown(markdown_content, extras=extras)
+
+
+class HTMLExporter:
+    """
+    HTML 导出器类
+    
+    将解析后的 Markdown 数据转换为 HTML 文件
+    
+    Attributes:
+        css_file (str): 自定义 CSS 样式文件路径，默认为 None
+        wrap_html (bool): 是否包装为完整的 HTML 文档，默认为 True
+    """
+    
+    def __init__(self, css_file: str = None, wrap_html: bool = True):
+        """
+        初始化 HTML 导出器
+        
+        Args:
+            css_file (str): 自定义 CSS 样式文件路径，可选
+            wrap_html (bool): 是否包装为完整的 HTML 文档，默认为 True
+                如果为 False，则只返回 HTML body 内容
+        """
+        self.css_file = css_file
+        self.wrap_html = wrap_html
+
+    def export(self, parsed_data: Dict[str, Any], output_path: str) -> None:
+        """
+        将解析后的 Markdown 数据导出为 HTML 文件
+        
+        该方法执行以下步骤：
+        1. 将 Markdown 内容转换为 HTML
+        2. 如果需要，将 HTML 包装在完整的 HTML 文档结构中
+        3. 将结果写入文件
+        
+        Args:
+            parsed_data (Dict[str, Any]): 包含 Markdown 解析结果的字典
+                - content: Markdown 内容
+                - title: 文档标题（可选）
+            output_path (str): 输出 HTML 文件的路径
+        """
+        html_content = _markdown_to_html(parsed_data['content'])
+        
+        if self.wrap_html:
+            html_content = self._wrap_html(html_content, parsed_data.get('title', 'Document'))
+        
+        output_dir = os.path.dirname(output_path)
+        if output_dir and not os.path.exists(output_dir):
+            os.makedirs(output_dir, exist_ok=True)
+        
+        with open(output_path, 'w', encoding='utf-8') as f:
+            f.write(html_content)
+
+    def export_to_string(self, parsed_data: Dict[str, Any]) -> str:
+        """
+        将解析后的 Markdown 数据转换为 HTML 字符串
+        
+        与 export 方法类似，但返回字符串而不是写入文件
+        
+        Args:
+            parsed_data (Dict[str, Any]): 包含 Markdown 解析结果的字典
+                - content: Markdown 内容
+                - title: 文档标题（可选）
+                
+        Returns:
+            str: HTML 内容字符串
+        """
+        html_content = _markdown_to_html(parsed_data['content'])
+        
+        if self.wrap_html:
+            html_content = self._wrap_html(html_content, parsed_data.get('title', 'Document'))
+        
+        return html_content
+
+    def _wrap_html(self, body_content: str, title: str) -> str:
+        """
+        将 HTML 内容包装在完整的 HTML 文档结构中
+        
+        添加 HTML 头部、元数据和样式，创建完整的 HTML 文档
+        
+        Args:
+            body_content (str): HTML 主体内容
+            title (str): 文档标题
+            
+        Returns:
+            str: 完整的 HTML 文档字符串
+            
+        Note:
+            内置样式包括：
+            - 中文字体支持（微软雅黑、黑体）
+            - 标题样式
+            - 代码块样式
+            - 表格样式
+            - 引用块样式
+            - 链接和图片样式
+        """
+        custom_css = self._get_custom_css()
+        
+        return f"""
+        <!DOCTYPE html>
+        <html>
+        <head>
+            <meta charset="UTF-8">
+            <meta name="viewport" content="width=device-width, initial-scale=1.0">
+            <title>{title}</title>
+            <style>
+                body {{
+                    font-family: 'Microsoft YaHei', 'SimHei', Arial, sans-serif;
+                    line-height: 1.6;
+                    margin: 20px;
+                    color: #333;
+                    max-width: 1200px;
+                    margin: 0 auto;
+                    padding: 20px;
+                }}
+                h1, h2, h3, h4, h5, h6 {{
+                    color: #2c3e50;
+                    margin-top: 20px;
+                    margin-bottom: 10px;
+                }}
+                code {{
+                    background-color: #f4f4f4;
+                    padding: 2px 6px;
+                    border-radius: 3px;
+                    font-family: 'Consolas', 'Monaco', monospace;
+                }}
+                pre {{
+                    background-color: #f4f4f4;
+                    padding: 15px;
+                    border-radius: 5px;
+                    overflow-x: auto;
+                }}
+                pre code {{
+                    background-color: transparent;
+                    padding: 0;
+                }}
+                blockquote {{
+                    border-left: 4px solid #ddd;
+                    margin: 0;
+                    padding-left: 20px;
+                    color: #666;
+                }}
+                table {{
+                    border-collapse: collapse;
+                    width: 100%;
+                    margin: 20px 0;
+                }}
+                th, td {{
+                    border: 1px solid #ddd;
+                    padding: 8px;
+                    text-align: left;
+                }}
+                th {{
+                    background-color: #f2f2f2;
+                }}
+                a {{
+                    color: #3498db;
+                    text-decoration: none;
+                }}
+                a:hover {{
+                    text-decoration: underline;
+                }}
+                img {{
+                    max-width: 100%;
+                    height: auto;
+                }}
+                hr {{
+                    border: none;
+                    border-top: 1px solid #ddd;
+                    margin: 20px 0;
+                }}
+                {custom_css}
+            </style>
+        </head>
+        <body>
+            {body_content}
+        </body>
+        </html>
+        """
+
+    def _get_custom_css(self) -> str:
+        """
+        获取自定义 CSS 样式
+        
+        如果设置了自定义 CSS 文件，则读取并返回其内容
+        
+        Returns:
+            str: CSS 样式字符串，如果没有设置或文件不存在则返回空字符串
+        """
+        if self.css_file and os.path.exists(self.css_file):
+            with open(self.css_file, 'r', encoding='utf-8') as f:
+                return f.read()
+        return ""

markconv-0.1.0/markconv/html_converter.py

@@ -0,0 +1,66 @@
+from typing import Optional
+from .parsers import MarkdownParser
+from .exporters import HTMLExporter
+
+
+class MDConverter:
+    """
+    Markdown 转换器主类
+    
+    提供统一的接口将 Markdown 文件转换为 HTML 格式
+    支持单个文件转换和批量转换
+    
+    Attributes:
+        parser (MarkdownParser): Markdown 解析器实例
+        html_exporter (HTMLExporter): HTML 导出器实例
+    """
+    
+    def __init__(self, encoding: str = 'utf-8', css_file: Optional[str] = None):
+        """
+        初始化 Markdown 转换器
+        
+        Args:
+            encoding (str): 文件编码格式，默认为 'utf-8'
+            css_file (Optional[str]): 自定义 CSS 样式文件路径，可选
+        """
+        self.parser = MarkdownParser(encoding=encoding)
+        self.html_exporter = HTMLExporter(css_file=css_file)
+
+    def to_html(self, input_path: str, output_path: Optional[str] = None, wrap_html: bool = True) -> None:
+        """
+        将 Markdown 文件转换为 HTML
+        
+        该方法执行以下步骤：
+        1. 验证输入文件是否存在
+        2. 如果未指定输出路径，则根据输入文件名生成输出路径
+        3. 解析 Markdown 文件
+        4. 导出为 HTML 文件
+        
+        Args:
+            input_path (str): 输入的 Markdown 文件路径
+            output_path (Optional[str]): 输出的 HTML 文件路径
+                如果为 None，则在输入文件同目录下生成同名 HTML 文件
+            wrap_html (bool): 是否包装为完整的 HTML 文档，默认为 True
+                如果为 False，则只输出 HTML body 内容
+                
+        Returns:
+            str: 输出 HTML 文件的完整路径
+            
+        Raises:
+            FileNotFoundError: 当输入文件不存在时抛出异常
+            
+        Example:
+            >>> converter = MDConverter()
+            >>> converter.to_html('input.md', 'output.html')
+            'output.html'
+            >>> converter.to_html('input.md')
+            'input.html'
+        """
+
+        parsed_data = self.parser.parse_file(input_path)
+        
+        html_exporter = HTMLExporter(css_file=self.html_exporter.css_file, wrap_html=wrap_html)
+        html_exporter.export(parsed_data, output_path)
+
+
+

markconv-0.1.0/markconv/parsers/__init__.py

@@ -0,0 +1,9 @@
+"""
+解析器模块
+
+提供 Markdown 文件和内容的解析功能
+"""
+
+from .markdown_parser import MarkdownParser
+
+__all__ = ['MarkdownParser']

markconv-0.1.0/markconv/parsers/markdown_parser.py

@@ -0,0 +1,116 @@
+import os
+from typing import Dict, Any
+
+
+class MarkdownParser:
+    """
+    Markdown 解析器类
+    
+    用于解析 Markdown 文件和内容，提取标题、元数据等信息
+    
+    Attributes:
+        encoding (str): 文件编码格式，默认为 'utf-8'
+    """
+    
+    def __init__(self, encoding: str = 'utf-8'):
+        """
+        初始化 Markdown 解析器
+        
+        Args:
+            encoding (str): 文件编码格式，默认为 'utf-8'
+        """
+        self.encoding = encoding
+
+    def parse_file(self, file_path: str) -> Dict[str, Any]:
+        """
+        解析 Markdown 文件
+        
+        从指定路径读取 Markdown 文件，并解析其内容
+        
+        Args:
+            file_path (str): Markdown 文件的路径
+            
+        Returns:
+            Dict[str, Any]: 包含解析结果的字典，包括：
+                - content: 原始 Markdown 内容
+                - title: 提取的标题
+                - metadata: 元数据字典
+                
+        Raises:
+            FileNotFoundError: 当文件不存在时抛出异常
+        """
+        if not os.path.exists(file_path):
+            raise FileNotFoundError(f"File not found: {file_path}")
+
+        with open(file_path, 'r', encoding=self.encoding) as f:
+            content = f.read()
+
+        return self.parse_content(content)
+
+    def parse_content(self, content: str) -> Dict[str, Any]:
+        """
+        解析 Markdown 内容字符串
+        
+        直接解析 Markdown 内容字符串，提取标题和元数据
+        
+        Args:
+            content (str): Markdown 内容字符串
+            
+        Returns:
+            Dict[str, Any]: 包含解析结果的字典，包括：
+                - content: 原始 Markdown 内容
+                - title: 提取的标题
+                - metadata: 元数据字典
+        """
+        return {
+            'content': content,
+            'title': self._extract_title(content),
+            'metadata': self._extract_metadata(content)
+        }
+
+    def _extract_title(self, content: str) -> str:
+        """
+        从 Markdown 内容中提取标题
+        
+        查找第一个一级标题（# 开头）作为文档标题
+        
+        Args:
+            content (str): Markdown 内容字符串
+            
+        Returns:
+            str: 提取的标题，如果没有找到则返回 'Untitled'
+        """
+        lines = content.split('\n')
+        for line in lines:
+            line = line.strip()
+            if line.startswith('# '):
+                return line[2:].strip()
+        return 'Untitled'
+
+    def _extract_metadata(self, content: str) -> Dict[str, str]:
+        """
+        从 Markdown 内容中提取元数据
+        
+        解析 YAML Front Matter 格式的元数据
+        元数据位于文档开头的 --- 分隔符之间
+        
+        Args:
+            content (str): Markdown 内容字符串
+            
+        Returns:
+            Dict[str, str]: 元数据字典，键值对形式存储
+        """
+        metadata = {}
+        lines = content.split('\n')
+        
+        in_metadata = False
+        for line in lines:
+            line = line.strip()
+            if line == '---':
+                in_metadata = not in_metadata
+                continue
+            if in_metadata and ':' in line:
+                key, value = line.split(':', 1)
+                metadata[key.strip()] = value.strip()
+        
+        return metadata

markconv-0.1.0/markconv.egg-info/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: markconv
+Version: 0.1.0
+Summary: 一个强大的 Markdown 转换工具库
+Home-page: https://github.com/Zheng-Enci/markconv
+Author: Zheng EnCi
+Author-email: zheng_enci@qq.com
+Project-URL: Bug Reports, https://github.com/Zheng-Enci/markconv/issues
+Project-URL: Source, https://github.com/Zheng-Enci/markconv
+Project-URL: Documentation, https://github.com/Zheng-Enci/markconv/blob/master/README.md
+Keywords: markdown html converter
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: markdown2>=2.5.5
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# markconv
+
+一个强大的 Markdown 转换工具库。
+
+**版本**: v0.1.0
+
+## 背景
+
+在日常开发中，我们经常需要将 Markdown 文档转换为其他格式（如 HTML、PDF、DOCX 等），但现有的解决方案存在诸多痛点：
+
+- **配置繁琐**：许多库需要复杂的配置和依赖管理，学习成本高
+- **中文支持差**：部分工具对中文显示支持不佳，需要额外配置字体和编码
+- **样式定制困难**：自定义样式需要深入了解工具的内部机制
+- **收费限制**：一些在线工具和商业软件需要付费，功能受限
+- **依赖繁重**：某些库依赖过多，安装和使用都不够轻量
+
+为了解决这些问题，我开发了 **markconv** —— 一个简单、高效、免费的 Markdown 转换工具库。
+
+## 简介
+
+markconv 是一个 Python 库，旨在提供简单易用的 Markdown 转换功能。该库支持将 Markdown 文档转换为多种格式，方便用户在不同场景下使用。
+
+**当前版本支持**：
+- Markdown → HTML
+
+**计划支持**：
+- Markdown → PDF
+- Markdown → DOCX
+- 更多格式...
+
+## 项目地址
+
+- **Gitee**: https://gitee.com/zheng-enci050704/markconv
+- **GitHub**: https://github.com/Zheng-Enci/markconv
+- **GitCode**: https://gitcode.com/ZhengEnCi/markconv
+
+## 功能特性
+
+- 📝 **简单易用**：提供简洁的 API 接口
+- 🚀 **高性能**：基于高效的转换引擎
+- 🔧 **可扩展**：支持自定义转换器和插件
+- 📦 **轻量级**：最小化依赖，易于集成
+- 🎨 **样式灵活**：支持自定义 CSS 样式
+- 🌐 **中文友好**：内置中文字体支持，UTF-8 编码
+
+## 安装
+
+### 从源码安装
+
+```bash
+# 选择一个源进行克隆
+git clone https://github.com/Zheng-Enci/markconv.git
+# 或
+git clone https://gitee.com/zheng-enci050704/markconv.git
+# 或
+git clone https://gitcode.com/ZhengEnCi/markconv.git
+
+# 安装依赖
+cd markconv
+pip install -r requirements.txt
+```
+
+### 使用安装脚本（推荐国内用户）
+
+项目提供了一个安装脚本，使用清华源加速依赖下载：
+
+```bash
+cd markconv
+python installl_requirements.py
+```
+
+该脚本会自动从清华源安装 `requirements.txt` 中的所有依赖项，速度更快。
+
+### 依赖项
+
+- Python 3.13+
+
+## 快速开始
+
+查看 `examples/` 目录获取完整示例。
+
+## 开发计划
+
+- [x] 实现 Markdown 到 HTML 的转换
+- [x] 支持自定义 CSS 样式
+- [x] 支持中文显示
+- [x] 自动创建输出目录
+- [ ] 添加更多代码高亮主题
+- [ ] 支持自定义主题模板
+- [ ] 添加命令行工具
+- [ ] 完善单元测试
+- [ ] 发布到 PyPI
+
+## 项目结构
+
+```
+markconv/
+├── markconv/                         # 主包目录
+│   ├── __init__.py                 # 包初始化文件 (v0.1.0)
+│   ├── html_converter.py           # HTML转换器核心模块
+│   ├── parsers/                    # 解析器模块
+│   │   ├── __init__.py
+│   │   └── markdown_parser.py      # Markdown解析器
+│   └── exporters/                  # 导出器模块
+│       ├── __init__.py
+│       └── html_exporter.py        # HTML导出器
+├── examples/                       # 示例代码
+│   └── html_example/
+│       ├── html_example.py         # HTML转换示例
+│       ├── sample.md               # 示例Markdown文件
+│       ├── custom.css              # 自定义CSS样式
+│       └── examples/
+│           └── sample.html         # 生成的HTML文件
+├── Note/                           # 笔记目录
+│   └── Update_logs/               # 更新日志
+├── README.md                       # 项目说明文档
+├── requirements.txt                # 依赖列表
+└── installl_requirements.py        # 安装脚本
+```
+
+## 贡献指南
+
+欢迎贡献代码！请遵循以下步骤：
+
+1. Fork 本项目
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 开启 Pull Request
+
+## 许可证
+
+MIT License
+
+## 致谢
+
+感谢所有为本项目做出贡献的开发者！
+
+---
+
+**注意**：本项目正在积极开发中，API 可能会有变化。建议关注版本更新日志。

markconv-0.1.0/markconv.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+setup.py
+markconv/__init__.py
+markconv/html_converter.py
+markconv.egg-info/PKG-INFO
+markconv.egg-info/SOURCES.txt
+markconv.egg-info/dependency_links.txt
+markconv.egg-info/requires.txt
+markconv.egg-info/top_level.txt
+markconv/exporters/__init__.py
+markconv/exporters/html_exporter.py
+markconv/parsers/__init__.py
+markconv/parsers/markdown_parser.py

markconv-0.1.0/markconv.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

markconv-0.1.0/markconv.egg-info/requires.txt

@@ -0,0 +1 @@
+markdown2>=2.5.5

markconv-0.1.0/markconv.egg-info/top_level.txt

@@ -0,0 +1 @@
+markconv

markconv-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

markconv-0.1.0/setup.py

@@ -0,0 +1,96 @@
+"""
+markconv 包的 setup 配置文件
+用于将项目发布到 PyPI
+"""
+
+from setuptools import setup, find_packages
+
+# 读取 README.md 作为长描述（会显示在 PyPI 网站上）
+with open('README.md', 'r', encoding='utf-8') as f:
+    long_description = f.read()
+
+# 调用 setup 函数配置包信息
+setup(
+    # ===== 基本信息 =====
+    
+    # 包名称（用户执行 pip install 时使用的名称）
+    name='markconv',
+    
+    # 版本号（遵循语义化版本规范：主版本.次版本.修订版本）
+    version='0.1.0',
+    
+    # 作者姓名
+    author='Zheng EnCi',
+    
+    # 作者邮箱（用于联系和问题反馈）
+    author_email='zheng_enci@qq.com',
+    
+    # 简短描述（显示在 PyPI 搜索结果中）
+    description='一个强大的 Markdown 转换工具库',
+    
+    # 长描述（显示在 PyPI 包详情页，从 README.md 读取）
+    long_description=long_description,
+    
+    # 长描述的内容类型（告诉 PyPI 是 Markdown 格式）
+    long_description_content_type='text/markdown',
+    
+    # 项目主页 URL（显示在 PyPI 网站上）
+    url='https://github.com/Zheng-Enci/markconv',
+    
+    # ===== 包配置 =====
+    
+    # 自动查找所有 Python 包（mdtool 及其子包）
+    packages=find_packages(),
+    
+    # ===== 分类器（帮助用户在 PyPI 上搜索和发现包）=====
+    classifiers=[
+        # 开发状态：3 - Alpha（早期开发版本）
+        'Development Status :: 3 - Alpha',
+        
+        # 目标受众：开发者
+        'Intended Audience :: Developers',
+        
+        # 主题：软件开发 -> Python 模块
+        'Topic :: Software Development :: Libraries :: Python Modules',
+        
+        # 许可证：MIT 开源许可证
+        'License :: OSI Approved :: MIT License',
+        
+        # 编程语言：Python 3
+        'Programming Language :: Python :: 3',
+        
+        # 编程语言：Python 3.13 特定版本
+        'Programming Language :: Python :: 3.13',
+        
+        # 操作系统：操作系统无关（跨平台）
+        'Operating System :: OS Independent',
+    ],
+    
+    # ===== Python 版本要求 =====
+    
+    # 要求 Python 版本 >= 3.13
+    python_requires='>=3.13',
+    
+    # ===== 依赖项（安装包时自动安装的依赖库）=====
+    install_requires=[
+        # 需要 markdown2 库，版本 >= 2.5.5
+        'markdown2>=2.5.5',
+    ],
+    
+    # ===== 搜索关键词（帮助用户搜索包）=====
+    
+    # 用户搜索时可以使用的关键词
+    keywords='markdown html converter',
+    
+    # ===== 项目链接（显示在 PyPI 网站上）=====
+    project_urls={
+        # 问题反馈链接
+        'Bug Reports': 'https://github.com/Zheng-Enci/markconv/issues',
+        
+        # 源代码链接
+        'Source': 'https://github.com/Zheng-Enci/markconv',
+        
+        # 文档链接（指向 README.md）
+        'Documentation': 'https://github.com/Zheng-Enci/markconv/blob/master/README.md',
+    },
+)