Metadata-Version: 2.1
Name: md2latex-converter
Version: 0.0.3.1
Summary: A md-to-LaTeX converter
Author: TrickEye
Author-email: TrickEye@buaa.edu.cn
License: MIT License
        
        Copyright (c) 2022 TrickEye
        
        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.
Description-Content-Type: text/markdown
License-File: LICENSE.txt

# `md2latex-converter` introduction 

> `pip install md2latex-converter`

`md2latex-converter` is a Python package that helps
to convert a .md (Markdown) file into a .tex (LaTeX)
file, with special support for Chinese, using the `ctex`
package provided by the LaTeX community.

`md2latex-converter` 是一个将 Markdown 文件转换成 LaTeX 
源代码的 Python 工具包。使用了 LaTeX 的 `ctex` 包，因此对于
中文的编码环境有特别的关照。

## Installation and Usage | 安装与使用

`pip install md2latex-converter`

This will install the package into your current python 
interpreter. The installation will add `m2l.exe` into 
the `Scripts` folder of python (on Windows) or `m2l` 
into `~/.local/bin/` by default (on Linux), if you have 
previously added the path above into your system PATH 
variable, you should be able to invoke the program 
through the command `m2l`.

这会在现有的 Python 解释器中安装此包。安装过程中会将 `m2l.exe` 安装在
当前的 Python 的 `Scripts` 路径（Windows）或默认将 `m2l` 安装到 
`~/.local/bin/` 路径（Linux）。如果此前已经将这个路径加入了 PATH 变量，
那么可以通过 `m2l` 指令来运行此程序。

`m2l file.md`

This will read and convert the content in `file.md` into `output.tex`
at the current working directory. After the conversion, use `xelatex output`
to produce a `.pdf` file from the LaTeX source code.

这会读取并转换 `file.md` 的内容到当前工作路径的 `output.tex` 文件。在此之后，可以使用
`xelatex output` 来编译产生 pdf

## Current progress and plans | 进度，安排

- Currently `m2l` basically supports plain text, title, 
unordered/ordered lists and pictures (please use a 
local path if you do so, otherwise you are being impolite
to LaTeX.) 
- The future versions will focus on equations, codeblocks and 
inline patterns (**bold**, _italic_,
[hyperlinks](#current-progress-and-plans--进度安排), `inline-code-snippets`, etc.)

- 现阶段支持了纯文本，标题，有/无序列表，图片（本地url）等。
- 未来版本计划支持公式、代码块和行内样式（**粗体**，_斜体_，
[超链接](#current-progress-and-plans--进度安排)，`行内代码`）
