# ldesign-formula

**Repository Path**: ldesign-v1/ldesign-formula

## Basic Information

- **Project Name**: ldesign-formula
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-11
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# @ldesign/formula

公式编辑器 - LaTeX 数学公式渲染与编辑。

## ✨ 特性

- 📐 **LaTeX 渲染** - 基于 KaTeX 的高性能公式渲染
- ✏️ **公式编辑** - 可视化公式编辑器
- 🔢 **模板库** - 内置常用数学公式模板
- 🎨 **主题切换** - 亮色/暗色主题
- 📱 **响应式** - 自适应不同屏幕尺寸
- ⚡ **高性能** - KaTeX 渲染引擎，比 MathJax 快数十倍

---

## 📦 安装

```bash
# 核心库
pnpm add @ldesign/formula

# Vue 组件
pnpm add @ldesign/formula-vue
```

---

## 🚀 快速开始

```typescript
import { createFormulaEditor } from '@ldesign/formula';

const editor = createFormulaEditor({
  container: '#formula-editor',
  onChange: (latex) => {
    console.log('公式:', latex);
  },
});
```

### 渲染公式

```typescript
import { renderLatex } from '@ldesign/formula';

const html = renderLatex('E = mc^2');
// 或渲染为 DOM 元素
const element = renderLatexToElement('\\int_0^\\infty e^{-x^2} dx = \\frac{\\sqrt{\\pi}}{2}');
```

---

## 📖 公式模板

| 分类 | 示例 |
|------|------|
| 基础运算 | $a + b$, $\frac{a}{b}$, $\sqrt{x}$ |
| 积分 | $\int_a^b f(x)dx$, $\iint$, $\oint$ |
| 求和 | $\sum_{i=1}^n a_i$, $\prod_{i=1}^n a_i$ |
| 矩阵 | $\begin{pmatrix} a & b \\ c & d \end{pmatrix}$ |
| 希腊字母 | $\alpha$, $\beta$, $\gamma$, $\delta$ |

---

## 🏗️ 项目结构

```
formula/
├── packages/
│   ├── core/          # 核心库 @ldesign/formula
│   │   └── src/
│   │       ├── core/           # 核心编辑器
│   │       ├── renderer/       # 渲染器 (KaTeX, DOM)
│   │       ├── toolbar/        # 工具栏与模板
│   │       ├── theme/          # 主题系统
│   │       └── types/          # TypeScript 类型
│   └── vue/           # Vue 组件
├── playground/        # 演示应用
└── README.md
```

---

## 🔧 开发

```bash
# 安装依赖
pnpm install

# 开发模式
pnpm dev

# 构建
pnpm build
```

---

## 📄 License

MIT