Saltar al contenido
Guía de Varlig
Inicio de Varlig

Escribir una línea de cálculo

En esta página se explican los fundamentos en los que se basa cualquier bloque de cálculo: cómo se lee una línea, cómo dejar notas junto a tus cuentas, cómo poner nombre a los valores y reutilizarlos, y cómo hacer que una línea dependa de una condición. Empieza por aquí si los cálculos de Varlig son nuevos para ti, y vuelve cuando un nombre o un comentario no se comporte como esperas.

Una expresión por línea

Los cálculos viven en un bloque de cálculo dentro de una nota. Escribe una línea ```calc o pulsa ⌘Y para insertar uno. Cada línea del bloque es un cálculo, y su resultado aparece junto a la línea.

calc
€3.40 * 5 da €17.00
45 min + 1 hour 20 min da 2 hours 5 min
1.5 litres in ml da 1,500 mL

Las líneas en blanco y las de comentario no tienen resultado, así que puedes espaciar un bloque y explicarlo sobre la marcha.

Varlig intenta leer primero toda la línea como una operación, incluidas frases cotidianas como €45 with 21% VAT. Si así no funciona, deja de lado las palabras que no reconoce, de modo que 5 manzanas + 3 naranjas sigue dando 8. Es práctico para apuntes rápidos, pero una descripción puede coincidir con una frase o con el nombre de una unidad, así que, cuando quieras indicar para qué sirve una línea, usa un comentario o un rótulo, como se explica a continuación. En Cómo lee Varlig una frase tienes los detalles.

Una palabra donde debería haber un valor da un error que nombra esa palabra, en vez de un resultado equivocado, y el mensaje te propone el nombre más parecido de los que has definido:

calc
alquiler = €1,150
alquler + €200 da Unsupported: unrecognized calculation at "alquler"; did you mean "alquiler"?

Lo mismo vale para un nombre escrito con dígitos o guiones bajos, como alquiler2 o alquiler_2. Nunca se aparta como descripción ni se lee como su número, y tampoco lo esconden los paréntesis, una llamada a una función o una conversión. En un rótulo los dígitos sí valen, así que describe ahí la línea:

calc
alquiler = €1,150
alquiler2 + €200 da Unsupported: unrecognized calculation at "alquiler2"; did you mean "alquiler"?
(alquler + €200) * 2 da Unsupported: unrecognized calculation at "alquler"; did you mean "alquiler"?
Piso 2: alquiler + €200 da €1,350.00

Líneas que empiezan por una viñeta

Una viñeta al principio de la línea la marca como un artículo de la lista de la compra: la descripción que va antes del importe se deja de lado y la línea sigue sumando. Usa -, *, •, +, – o — y un espacio:

calc
- flores 1,200 da 1,200
* café €4.50 da €4.50
- 12 tazas da 12
- 6 plátanos @ €0.18 da €1.08
- 500g pasta 3 packs at €1.10 each da €3.30

Un guion delante de un importe a secas sigue siendo un signo menos, así que - 1,200 es -1,200 y - 12 kg es -12 kg. Para anotar una medida en una lista, empieza la línea por * o •, que son viñetas antes que ninguna otra cosa.

Palabras junto a un importe

Una descripción hace la línea más legible y nunca cambia el número. Las palabras unidas por +, & o per forman parte de la descripción y no de una suma, un signo menos pegado a su importe pertenece al importe, y un número de referencia detrás de una palabra no estorba:

calc
lavabo + pedestal €145 da €145.00
comida per cápita €14.20 da €14.20
leche, pan, huevos €12.40 da €12.40
Netflix -€10.99 da -€10.99
RECIBO DOMICILIADO REF 4471 €62.40 da €62.40
Factura #123: €250 da €250.00
double cream 600 mL da 600 mL
cloro 3 ppm da 3 ppm
sofá-cama €349 da €349.00
on the day 60 at €28 da €1,680.00

Con eso queda cubierto casi todo lo que te encuentras al pegar un extracto bancario, la confirmación de un pedido o una lista de materiales: filas en mayúsculas, cosas enumeradas con comas, nombres con guion y una línea cuya descripción empieza justo por una palabra que Varlig conoce, como double, per u on the day.

Un rótulo que numera una fila, como Año 2, Habitación 12 o Presupuesto 2026, o un periodo con su año, como Q4 2026, July 2026 o week 40 2027, también forma parte de la descripción, esté donde esté en la línea, cuando le sigue su importe: un importe con moneda, unidad o signo de porcentaje, o un número sin más que queda solo antes del siguiente operador. Su número nunca se suma:

calc
Año 1 €5,000 + Año 2 €6,000 da €11,000.00
Año 1 5,000 + Año 2 6,000 da 11,000
Presupuesto 2025 €1,200 + Presupuesto 2026 €1,500 da €2,700.00
Habitación 12 €40 + Habitación 14 €50 da €90.00
Q3 2026 €5,000 + Q4 2026 €6,000 da €11,000.00
July 2026 €500 + August 2026 €600 da €1,100.00

Un único número detrás de una palabra es el importe, como en alquiler 1200 + 300, y una cantidad sigue contando, como en entradas 2 €40 each. Una unidad como hour, week o day mide el número que tiene delante; escrita delante de un número, nombra la fila como cualquier otra palabra: hour 2 es la segunda hora, nunca una hora y dos minutos. Y cuando sigue una moneda, una unidad o un signo de porcentaje, un espacio después del número de un rótulo da paso al importe, así que Semana 2 150 hours son 150 horas y no 2,150:

calc
hour 1 €40 + hour 2 €50 da €90.00
hours 8 + hours 7 da 15
Semana 2 150 hours + Semana 3 160 hours da 310 hours

Comentarios

Un comentario es texto que la calculadora ignora. Hay cuatro formas de escribirlo:

Forma Ejemplo Qué se ignora
Comentario con almohadilla alquiler * 12 # al año o # Presupuesto Todo desde un # seguido de espacio hasta el final de la línea
Comentario con barras alquiler * 12 // al año Todo desde // hasta el final de la línea
Nota entre comillas "cafés con leche" €3.40 * 5 Todo lo que va entre comillas dobles, en cualquier parte de la línea
Nota entre paréntesis €999 (para el iPhone 16) Las palabras entre paréntesis, en cualquier parte de la línea
calc
# Compra semanal
leche = €1.45
pan = €1.20 // de masa madre
huevos = €2.30 "camperos"
leche + pan + huevos # sin extras da €4.95

Una almohadilla o unas barras comentan el resto de la línea, mientras que las comillas y los paréntesis pueden ir en mitad de ella. Así puedes decir para qué es un importe sin cortar la cuenta:

calc
€999 (para el iPhone 16) da €999.00
portátil €899 (reacondicionado) + €49 funda da €948.00
Boing "747" cuesta 386.8M € da €386.8M

Las comillas son la opción más segura alrededor de algo que parece un número, que es como el 747 de arriba se queda fuera de la operación. Un paréntesis que contiene solo un número es aritmética y no una nota, porque un número junto a un paréntesis multiplica:

calc
€999 (3) da €2,997.00

Así que escribe la cantidad fuera del paréntesis, o di qué estás contando, como en €999 (3 teléfonos). Cualquier cosa que no sea un número a secas sigue siendo una nota, incluida una palabra con guion o un porcentaje:

calc
€134 (25% de descuento ya aplicado) da €134.00
€10 (para mi ex-jefe) da €10.00

Una línea que empieza por una almohadilla y un espacio es un comentario de principio a fin, lo que la convierte en un encabezado práctico dentro de un bloque.

El espacio es lo que convierte una almohadilla en comentario. Un # pegado a una palabra, como en #comida, es una etiqueta: identifica la línea, se queda fuera del cálculo y te permite sumar todas las líneas que la llevan, estén donde estén dentro del bloque.

calc
€12.50 almuerzo #comida da €12.50
€8 café #comida da €8.00
total of #comida da €20.50

Una almohadilla seguida de dígitos no es ni lo uno ni lo otro: numera aquello de lo que habla la línea y no interviene en la operación, así que las facturas, los pedidos y los números de pieza se leen tal como se escriben.

calc
Factura #123: €250 da €250.00
pieza #4 pesa 20 g da 20 g

Rótulos

Un rótulo son unas pocas palabras seguidas de dos puntos y un espacio al principio de una línea. Describe el resultado sin formar parte de la operación:

calc
alquiler = €1,250
gastos = €180
Alquiler y gastos: alquiler + gastos da €1,430.00
Cuenta del café: €12.50 + €4 da €16.50

Los rótulos pueden llevar letras (también con tilde o acento), dígitos, espacios y guiones bajos, como en Piso 2: o alquiler T3:.

Un rótulo no crea un nombre. Después de Alquiler y gastos: alquiler + gastos, no hay ningún valor llamado Alquiler y gastos. Usa = cuando quieras reutilizar un resultado. Evita también poner un rótulo delante de una asignación: Vivienda: alquiler = €1,250 muestra el importe, pero alquiler no se guarda.

Asignación

= le da un nombre a un valor. La línea también muestra el valor, para que puedas comprobarlo sobre la marcha.

calc
precio = €85 da €85.00
precio + 20% da €102.00

Para actualizar un nombre que ya has definido, usa +=, -=, *= o /=:

calc
fondo de vacaciones = €400
fondo de vacaciones += €150 da €550.00
fondo de vacaciones -= €85 da €465.00
raciones = 4
raciones *= 3 da 12
harina = 750 g
harina /= 3 da 250 g

Si el lado derecho falla, el nombre guarda el error, y todas las líneas que lo usan muestran el mismo error hasta que vuelvas a asignar el nombre:

calc
invitados = 0
por persona = €120 / invitados da Error: divide by zero
por persona + €5 da Error: divide by zero

Un nombre que guardas puede llevar una descripción, igual que la llevaría en una línea suelta. Lo que no puede haber a la derecha del = son palabras sueltas envolviendo un nombre a secas, porque entonces no hay forma de saber qué querías guardar: con alquiler = €1,150 definido, x = gastado excl alquiler avisa de gastado excl alquiler en lugar de guardar el alquiler sin decir nada.

calc
alquiler pagado = €1,150
gasto diario = alquiler pagado / 16 da €71.88

Nombres

Los nombres pueden tener varias palabras y pueden contener letras con tilde o de otros alfabetos, dígitos, guiones bajos y emojis:

calc
café con leche = €3.40
café con leche * 5 da €17.00
tarta de limón = €6.50
tarta de limón * 2 da €13.00
🍎 precio = €0.45
🍎 precio * 6 da €2.70
ventas t1 = €12,400
ventas t2 = €14,100
ventas t1 + ventas t2 da €26,500.00
ancho_dormitorio = 3.2 m
ancho_dormitorio * 2 da 6.4 m

Un nombre puede incluir palabras que Varlig usa en otros contextos, como to, in o unidades como bar y cal, y puede tomar prestado el nombre de una función integrada, como floor. Siempre que lo uses como valor, Varlig lee tu valor:

calc
tiempo en el bar = 25 min
tiempo en el bar * 10 da 250 min
pintura a la cal = 12.44 L
pintura a la cal to 1 dp da 12.4 L
floor = 12 m²
floor * 2 da 24 m²
floor(3.7) da 3

Seguida de paréntesis, como en floor(3.7), la función sigue haciendo su trabajo habitual.

Un nombre puede incluso terminar en un número escrito con letras, así que un precio se lee tal como aparece en la carta:

calc
mesa para cuatro = €96
mesa para cuatro / 4 da €24.00

Cuando dos de tus nombres empiezan igual, gana el más largo, así que un nombre numerado se lee entero:

calc
tanda = €8.01
tanda 2 = €8.21
tanda 2 - tanda da €0.20

Los nombres distinguen entre mayúsculas y minúsculas: huevos y Huevos son dos valores distintos.

Si quieres que un nombre esté disponible en todas las notas, como tu tarifa por hora o un tipo de impuesto, añádelo a las definiciones globales de los ajustes en lugar de repetirlo en cada nota.

Nombres que coinciden con palabras integradas

Un nombre que defines tiene prioridad sobre cualquier otra cosa que se escriba igual, como una unidad, un número escrito con palabras o una constante. Aun así, los nombres cotidianos no alteran tus cantidades. Un número escrito justo delante de un nombre en plural o de una unidad cuenta esa cosa, y un porcentaje delante de tip o tax designa la propina o el impuesto, así que los valores llamados hours, nights o tip no cambian estas líneas:

calc
tarifa = €14 / hour
hours = 7.5
tarifa * 7.5 hours da €105.00
nights = 14
€118/night * 14 nights da €1,652.00
tip = €12.69
€84.60 + 18% tip da €99.83

Mantén el puntero sobre la palabra para ver cómo la ha leído Varlig. En tarifa * 7.5 hours indica "Counts hours here, not the variable hours = 7.5." En cualquier otra posición de la línea, el nombre es tu valor, como en split €90 among personas.

Una conversión funciona igual: después de in, to o as, una unidad gana a un nombre que contiene un número sin más, así que un recuento al que has puesto nombre no bloquea la conversión a esa unidad. Con miles = 12, 20 km in miles sigue dando 12.4274238447 mi. Un nombre delante de la unidad la escala en vez de designar un destino, así que 15.2 m in escala miles con escala = 76.2 avisa de Unsupported: conversion to escala miles en lugar de quedarse con una de las dos lecturas.

Una unidad escrita como tarifa, sin espacios alrededor de la barra, se lee como esa unidad independientemente del uso que hayas dado a sus letras en otro sitio, así que una densidad o una velocidad copiadas de una ficha técnica siguen significando lo que dicen:

calc
g = 9.81 m/s²
2 g da 19.62 m/s²
2.7 g/cm³ da 2.7 g/cm³
50 kg * g da 490.5 N

En algunos casos, tu definición sí cambia el significado de una línea:

  • Una sola letra siempre es tu valor, así que después de m = 3, 2 m es 6 y no dos metros.
  • Un número delante de un nombre en singular lo multiplica, así que después de ancho = 3, 2 ancho es 6. Lo mismo ocurre con un nombre de una sola letra delante de una unidad o de un operador. El aviso lo indica y propone escribir 2 * ancho para que quede claro.
  • Los números escritos con palabras y las constantes también se sustituyen: después de one = 7, one times two es 14.

Dos hábitos evitan la mayoría de las sorpresas:

  • No uses como nombres, por sí solos, símbolos de unidades como m, s, h o in, ni reutilices constantes y números escritos con palabras como pi, one o i.
  • Prefiere nombres descriptivos como horas trabajadas, tarifa diaria o distancia recorrida.

Orden del documento

Cada línea ve los nombres definidos encima de ella. Los nombres también pasan a los bloques de cálculo posteriores de la misma nota, así que puedes definir tus datos una vez y usarlos más abajo.

calc
precio = €20
cantidad = 3
importe = precio * cantidad da €60.00
precio = €25
precio * cantidad da €75.00
importe da €60.00

Volver a definir precio no cambia la línea anterior de importe: importe se calculó con el precio que había en ese momento. Para cambiar el resultado de un cálculo anterior, edita la línea donde se define su dato.

El resultado de arriba

prev es el resultado de la línea más cercana de arriba, y ans significa lo mismo, salvo que hayas llamado ans a un valor. Son prácticos para una operación rápida a continuación:

calc
€1,250 * 12 da €15,000.00
prev / 52 da €288.46
ans + €20 da €308.46

Para sumar un grupo de líneas, escribe sum o total en una línea propia. Consulta Sumar las líneas de arriba.

Referirse a una línea por su número

line1, line2 y así sucesivamente se refieren a un cálculo por su posición en la nota, contando todos los bloques de cálculo por orden:

calc
precio = €100 da €100.00
line1 * 2 da €200.00

Una referencia se queda asociada a la fila a la que apunta. Inserta una línea encima, o mueve líneas con Formato › Subir línea y Bajar línea, y el resultado sigue usando la misma fila: Varlig renumera el texto por ti, como un paso de deshacer propio, para que lo que lees y lo que obtienes coincidan.

Si eliminas la fila a la que apunta una referencia, la línea dice Error: line2 refers to a deleted line en lugar de usar otro número sin decir nada. Undo las recupera las dos.

Copiar y pegar conserva las referencias

Copia o corta líneas de cálculo y pégalas, y sus referencias line2 y ↑ siguen leyendo las líneas que leían antes:

  • Una referencia a una línea que has copiado sigue a la copia, renumerada según dónde quede.
  • Una referencia a una línea que no has copiado sigue leyendo esa línea cuando pegas en la misma nota.
  • Si pegas en otra nota, pasa a ser el nombre que define esa línea, como alquiler para alquiler = €1,200, que funciona en cuanto la nota lo define o lo usa. Una línea sin nombre pasa a ser una referencia como line2_of_Budget, que lo indica hasta que la sustituyas:
calc
5 + line2_of_Budget da Unsupported: line2_of_Budget is a line of another note

El portapapeles guarda solo el texto que has seleccionado, así que las demás apps reciben exactamente eso, y el pegado es un solo paso de deshacer. Las líneas copiadas de una nota protegida con contraseña se pegan tal como están escritas.

Convertir un texto en un cálculo

¿Has pegado una factura, o has escrito unas líneas que deberían ir sumando? Selecciona las líneas y elige Formato › Convertir en bloque de cálculo, o pulsa ⌘Y con una selección: Varlig las envuelve en un bloque de cálculo como una sola edición que puedes deshacer, y los resultados aparecen a su lado.

Sin nada seleccionado, ⌘Y inserta un bloque vacío. El texto de fuera de un bloque no se calcula nunca, así que un correo pegado conserva sus números, sus fechas y sus referencias de factura tal y como están.

Reiniciar el ámbito

Una línea que solo contiene --- inicia un ámbito nuevo. Los nombres, las unidades personalizadas y las funciones propias definidos encima dejan de verse debajo. Es útil para comparar dos escenarios en una misma nota sin que sus valores se mezclen.

calc
# Opción A: el apartamento en el centro
alquiler = €1,250
transporte = €60
alquiler + transporte da €1,310.00
---
# Opción B: el apartamento a las afueras
alquiler = €980
transporte = €210
alquiler + transporte da €1,190.00

Debajo de ---, hay que volver a definir transporte. Si se te olvida, la línea que lo usa no tiene nada a lo que referirse.

Condicionales

if … then … else … elige uno de dos valores según una comparación. Puedes usarlo solo o asignar el resultado a un nombre:

calc
carrito = €34.50
entrega = if carrito >= €40 then €0 else €3.99 da €3.99
carrito + entrega da €38.49

Encadena else if para tener más de dos resultados posibles:

calc
carrito = €34.50
if carrito < €20 then €4.99 else if carrito < €40 then €2.99 else €0 da €2.99

Solo se calcula la rama elegida, así que la otra rama puede contener algo que fallaría:

calc
invitados = 0
if invitados > 0 then €120 / invitados else €0 da €0.00

If y unless después del valor

También puedes poner la condición después del valor. valor if condición muestra el valor cuando se cumple la condición, y valor unless condición lo muestra cuando no se cumple. En los dos casos, si no, la línea no muestra nada.

calc
carrito = €34.50
€3.99 if carrito < €40 da €3.99
€3.99 unless carrito >= €40 da €3.99

El valor puede ser un texto entre comillas dobles, lo que convierte una comprobación en una línea que te dice cómo vas y que el resto del tiempo se queda en blanco:

calc
conversión = 0.667%
"vamos bien" if conversión > 0.5% da vamos bien

Asignar dentro de un condicional

Las dos ramas pueden asignar un valor al mismo nombre:

calc
carrito = €34.50
if carrito >= €40 then envío = €0 else envío = €3.99 da €3.99
envío da €3.99

Con solo una rama then, la asignación se hace cuando se cumple la condición y, si no, el nombre conserva su valor anterior:

calc
carrito = €34.50
puntos = 0
if carrito > €30 then puntos = 50 da 50
puntos da 50

Las comparaciones como >= y los operadores && y || se explican en Operadores, comparaciones y condicionales.

Todo junto

Esta es una pequeña factura de trabajo freelance, escrita como la tendrías en una nota:

calc
# Factura de marzo
tarifa diaria = €420
días trabajados = 6
desplazamientos = €86.40 // billetes de tren
honorarios = tarifa diaria * días trabajados da €2,520.00
subtotal = honorarios + desplazamientos da €2,606.40
factura con IVA = true
IVA = if factura con IVA then subtotal * 21% else €0 da €547.34
Total a pagar: subtotal + IVA da €3,153.74

Todos los datos tienen nombre, así que el mes que viene solo cambias días trabajados y desplazamientos, y el resto de la factura se actualiza. Los comentarios y el rótulo hacen que el bloque se lea bien, y el condicional permite que la misma nota sirva tanto si cobras IVA como si no.