CalcNote

CalcNote es una aplicación de escritorio minimalista para Windows que permite a ingenieros y científicos escribir, ejecutar y documentar cálculos matemáticos de forma visual. Combina un editor de código Python con renderizado LaTeX profesional.

Características

• 📝 Editor split-pane - Código a la izquierda, preview renderizado a la derecha
• 🧮 Renderizado LaTeX profesional - Ecuaciones hermosas con KaTeX
• 🐍 100% Python - Sin overhead de Jupyter, ejecución directa
• 📊 Motor LaTeX propio - Fork optimizado de handcalcs integrado
• 🔢 4 modos de render - params, long, short, symbolic
• 📄 Interpolación Markdown - Variables dinámicas en texto
• 💾 Formato .calc - Guarda y abre documentos fácilmente

Instalación

Desarrollo

# Clonar repositorio
git clone https://github.com/user/calcnote.git
cd calcnote

# Instalar dependencias (con uv)
uv sync --all-extras

# O con pip
pip install -e ".[dev]"

Ejecutar

# Modo desarrollo
python -m calcpad

# O usando el script
calcpad

Uso Básico

Calcpad usa directivas %% para indicar cómo procesar cada bloque:

%%md
# Cálculo de Viga
Viga simplemente apoyada con carga distribuida.

%%render params
L = 5  # Longitud [m]
w = 10  # Carga [kN/m]

%%render
M_max = w * L**2 / 8

Directivas Soportadas

Directiva	Descripción
%%render	Renderiza expresiones a LaTeX
%%render params	Tabla de parámetros alineados
%%render long	Muestra pasos intermedios
%%render short	Solo resultado final
%%render symbolic	Solo expresión simbólica
%%md	Renderiza Markdown con {variables}
%%code	Ejecuta sin renderizar
%%hide	Ejecuta pero oculta output
%%tex	LaTeX raw directo

Atajos de Teclado

Atajo	Acción
Ctrl+Enter	Ejecutar todo
Ctrl+S	Guardar
Ctrl+O	Abrir
Ctrl+N	Nuevo documento

Licencia

MIT License

---

Stack Técnico

• Python 3.11+ con PySide6 (Qt6)
• Motor LaTeX propio (calcnote.latex_engine)
• KaTeX para renderizado en navegador
• pyparsing para parsing de expresiones

Ver LATEX_ENGINE.md para detalles del motor de renderizado.