Markdown2LaTeX

一键将 Markdown 转换为 LaTeX 文档 🚀

这是一个 VSCode 插件，可以快速将 Markdown 文档转换为 LaTeX 格式，支持数学公式、表格、GitHub Flavored Markdown (GFM) 等扩展语法。

✨ 特性

🎯 一键转换：右键菜单点击即可转换
📐 数学公式支持：完美支持行内公式 $...$ 和块级公式 $$...$$
📊 表格转换：自动将 Markdown 表格转换为 LaTeX tabular 环境
🎨 GFM 支持：支持 GitHub Flavored Markdown 扩展语法（删除线、任务列表等）
⚙️ 高度可配置：文档类型、数学环境、自定义包等均可配置
🇨🇳 中文支持：内置 xeCJK 包，完美支持中文
💾 灵活输出：可选择包含完整文档结构或仅输出内容部分
⚡ 本地处理：所有转换在本地完成，无需网络，保护隐私

📦 安装

方式 1：从 VSCode Marketplace 安装（推荐）

打开 VSCode
按 Ctrl+Shift+X (Windows/Linux) 或 Cmd+Shift+X (macOS) 打开扩展面板
搜索 "Markdown2LaTeX"
点击 "安装"

方式 2：从 VSIX 文件安装

下载最新的 .vsix 文件
在 VSCode 中按 Ctrl+Shift+P 打开命令面板
输入 "Install from VSIX..."
选择下载的 .vsix 文件

方式 3：从源码构建

git clone https://github.com/Cici2014/markdown2latex.git
cd markdown2latex
npm install
npm run compile
# 按 F5 在扩展开发主机中运行

🚀 快速开始

使用方法

打开 Markdown 文件
选择以下任一方式转换：
- 右键点击编辑器，选择 "Markdown to LaTeX"
- 使用快捷键 Ctrl+Shift+L (Windows/Linux) 或 Cmd+Shift+L (macOS)
- 点击编辑器右上角的图标
- 按 Ctrl+Shift+P 打开命令面板，输入 "Markdown to LaTeX"
- 点击状态栏的 "Markdown → LaTeX" 按钮
查看结果：转换后的 LaTeX 代码将在新窗口中显示
保存文件：选择是否保存为 .tex 文件

转换演示

右键菜单选择 "Markdown to LaTeX" 进行转换

⚠️ 中文支持重要提示

如果文档包含中文，必须使用 XeLaTeX 编译器！

Overleaf 用户

打开生成的 .tex 文件
点击左上角的 "File" 按钮
在下拉框中选择 "Settings"
找到 "Compiler" 选项
将编译器改为 "XeLaTeX"
点击 "Recompile" 重新编译

配置 XeLaTeX 编译器

本地编译

# 使用 XeLaTeX 编译（推荐）
xelatex document.tex

# 或使用 LuaLaTeX
lualatex document.tex

# ❌ 不要使用 pdfLaTeX（不支持中文）

示例

Markdown 输入：

# 论文标题

## 摘要

这是一篇关于 **机器学习** 的论文。

## 数学公式

爱因斯坦质能方程：$E = mc^2$

积分公式：

$$
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

## 表格

| 算法 | 准确率 | 时间复杂度 |
|------|--------|-----------|
| SVM  | 95%    | O(n²)     |
| RF   | 92%    | O(n log n)|

## 代码

```python
def hello():
    print("Hello, LaTeX!")


**LaTeX 输出：**

```latex
\documentclass{article}

% 包引入
\usepackage{amsmath}
\usepackage{graphicx}
\usepackage{hyperref}
\usepackage{xeCJK}
\usepackage{listings}

% 中文支持配置
\setCJKmainfont{SimSun}

\begin{document}

\section{论文标题}

\subsection{摘要}

这是一篇关于 \textbf{机器学习} 的论文。

\subsection{数学公式}

爱因斯坦质能方程：$E = mc^2$

积分公式：

\begin{equation}
\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
\end{equation}

\subsection{表格}

\begin{tabular}{l l l}
\hline
算法 & 准确率 & 时间复杂度 \\
\hline
SVM & 95\% & O(n²) \\
RF & 92\% & O(n log n) \\
\hline
\end{tabular}

\subsection{代码}

\begin{lstlisting}[language=python]
def hello():
    print("Hello, LaTeX!")
\end{lstlisting}

\end{document}

预览效果

Overleaf 预览

在 Overleaf 中查看编译后的 PDF 效果

⚙️ 配置选项

在 VSCode 设置中搜索 markdown2latex 可配置以下选项：

`markdown2latex.documentClass`

类型：string
默认值："article"
可选值："article", "report", "book", "standalone"
说明：LaTeX 文档类型

`markdown2latex.includePreamble`

类型：boolean
默认值：true
说明：是否包含完整的 LaTeX 前导码（\documentclass、包引入、\begin{document} 等）

`markdown2latex.mathEnvironment`

类型：string
默认值："equation"
可选值："equation", "align", "displaymath"
说明：块级数学公式使用的环境类型

`markdown2latex.customPackages`

类型：array
默认值：["amsmath", "graphicx", "hyperref", "xeCJK", "listings"]
说明：自定义需要引入的 LaTeX 包

`markdown2latex.autoSave`

类型：boolean
默认值：false
说明：转换后是否自动保存为 .tex 文件

`markdown2latex.outputDirectory`

类型：string
默认值：""
说明：输出文件的默认目录（留空则与源文件同目录）

📖 支持的 Markdown 语法

基础语法

✅ 标题 (H1-H6)
✅ 段落
✅ 粗体 (**text**)
✅ 斜体 (*text*)
✅ 行内代码 (`code`)
✅ 代码块
✅ 链接
✅ 图片
✅ 有序列表
✅ 无序列表
✅ 引用块
✅ 水平分隔线

GFM 扩展语法

✅ 表格
✅ 删除线 (~~text~~)
✅ 任务列表

数学公式

✅ 行内公式： $E = mc^2$
✅ 块级公式：
```
$$
\int_0^\infty e^{-x^2} dx
$$
```
✅ LaTeX 数学环境（align, equation 等）

LaTeX 命令映射

Markdown	LaTeX
`# 标题`	`\section{标题}`
`## 标题`	`\subsection{标题}`
`### 标题`	`\subsubsection{标题}`
`粗体`	`\textbf{粗体}`
`斜体`	`\textit{斜体}`
`代码`	`\texttt{代码}`
`[text](https://github.com/Cici2014/markdown2latex/blob/HEAD/url)`	`\href{url}{text}`
`![alt](https://github.com/Cici2014/markdown2latex/raw/HEAD/img)`	`\includegraphics{img}`
`- 列表`	`\begin{itemize}\item 列表`
`1. 列表`	`\begin{enumerate}\item 列表`
`> 引用`	`\begin{quote}引用\end{quote}`

🎓 使用场景

📝 学术论文：将 Markdown 草稿快速转换为 LaTeX 提交格式
📚 技术文档：编写技术文档时享受 Markdown 的简洁和 LaTeX 的专业
🔬 科研笔记：用 Markdown 记录，需要时转换为 LaTeX
📖 书籍写作：使用 Markdown 写作，输出 LaTeX 排版
🎯 演示文稿：配合 Beamer 类制作学术演示

🔧 技术栈

TypeScript：类型安全的开发体验
remark：强大的 Markdown 解析器
unified：统一的内容转换生态系统
VSCode Extension API：原生插件开发

为什么使用 remark？

本插件采用纯 JavaScript/TypeScript 实现的 remark 库进行转换，而非依赖外部的 Pandoc：

✅ 开箱即用：无需安装外部依赖
✅ 隐私保护：所有处理在本地完成
✅ 速度快：毫秒级转换响应
✅ 跨平台：Windows、macOS、Linux 完全一致
✅ 轻量级：插件体积小
✅ 可定制：完全可控的转换逻辑

🐛 问题反馈

如果遇到问题或有功能建议，请：

查看常见问题 (FAQ)
在 GitHub Issues 提交问题
提供以下信息：
- VSCode 版本
- 插件版本
- 操作系统
- 错误信息
- 复现步骤

🤝 贡献

欢迎贡献！请查看贡献指南。

开发

# 克隆仓库
git clone https://github.com/Cici2014/markdown2latex.git
cd markdown2latex

# 安装依赖
npm install

# 编译
npm run compile

# 运行测试
npm test

# 监听文件变化
npm run watch

# 打包
npm run package

📄 许可证

MIT License

🙏 致谢

remark - 强大的 Markdown 处理器
unified - 内容转换生态系统
VSCode - 优秀的编辑器平台

📊 版本历史

查看 CHANGELOG.md 了解详细的版本变更记录。

v0.1.0 (当前版本)

🎉 首次发布
✅ 基础 Markdown 语法支持
✅ 数学公式支持
✅ 表格转换
✅ GFM 扩展语法
✅ 可配置选项
✅ 中文支持

享受 Markdown 的简洁，拥抱 LaTeX 的强大！ 💪

如果觉得这个插件有用，欢迎 ⭐ Star 支持！

Markdown2LaTeX

fastpen

Markdown2LaTeX

✨ 特性

📦 安装

方式 1：从 VSCode Marketplace 安装（推荐）

方式 2：从 VSIX 文件安装

方式 3：从源码构建

🚀 快速开始

使用方法

⚠️ 中文支持重要提示

Overleaf 用户

本地编译

示例

预览效果

⚙️ 配置选项

markdown2latex.documentClass

markdown2latex.includePreamble

markdown2latex.mathEnvironment

markdown2latex.customPackages

markdown2latex.autoSave

markdown2latex.outputDirectory

📖 支持的 Markdown 语法

基础语法

GFM 扩展语法

数学公式

LaTeX 命令映射

🎓 使用场景

🔧 技术栈

为什么使用 remark？

🐛 问题反馈

🤝 贡献

开发

📄 许可证

🙏 致谢

📊 版本历史

v0.1.0 (当前版本)

`markdown2latex.documentClass`

`markdown2latex.includePreamble`

`markdown2latex.mathEnvironment`

`markdown2latex.customPackages`

`markdown2latex.autoSave`

`markdown2latex.outputDirectory`