Calca for Mac 是一款将文本编辑、数学计算和实时预览完美融合的独特工具。它不仅仅是一个计算器，更是一个“可计算文档”的创作环境。用户可以在一个清晰的Markdown风格文档中编写文字、定义变量、建立公式，而Calca会实时计算并显示所有结果，任何输入的更改都会立即触发整个文档的重新计算，极大地提升了涉及复杂计算、财务建模、数据分析或学术研究的文档编写效率。

一、核心界面与工作区详解

Calca 的界面设计秉承了Mac应用的简洁美学，主要分为三个核心区域：

工具栏：位于窗口顶部，包含最常用的操作按钮，如新建、打开、保存、导出、搜索以及切换显示模式。
编辑区（左侧）：这是用户的主要工作区域。在此处输入纯文本内容，支持Markdown基础语法。Calca的核心语法（如变量定义、计算表达式）也在此编写。界面为纯文本，无按钮干扰。
预览区（右侧）：实时显示编辑区内容的渲染结果。所有以 = 开头的计算表达式的结果，都会在此区域紧跟在对应文本行后显示。此区域为只读，用于即时查看最终文档效果。

两个区域通常以垂直分割线隔开，用户可以通过拖动分割线调整比例，或使用菜单栏的“View” > “Toggle Editor/Preview” (Cmd + ) 来切换焦点或隐藏预览区。

二、完整工作流程：从创建到导出

1. 创建或打开项目

操作：启动Calca后，会自动创建一个新的空白文档。若要新建，请点击菜单栏 “File” > “New” (Cmd + N)。若要打开已有的 .calca 或文本文件，点击 “File” > “Open” (Cmd + O)。

2. 编写内容与进行计算

在编辑区，你可以自由混合编写普通文本和计算指令。

普通文本：直接输入，支持Markdown标题（#）、列表（-， 1.）、粗体（**）等。
定义变量：输入 变量名 = 值或表达式，例如 price = 99.99 或 taxRate = 0.08。按回车后，右侧预览区会立即显示该行，并在行末显示计算结果。
进行计算：在任何一行，输入以等号 = 开头的表达式，例如 = price * (1 + taxRate)。Calca会计算并直接在预览区该行后显示结果。
使用函数：Calca内置丰富的数学、财务、统计函数，如 = sqrt(16)， = PV(0.05/12, 30*12, -1000)。

3. 组织与格式化文档

利用Markdown和Calca的特性使文档结构清晰：

使用 # 标题 创建章节。
使用三个连字符 --- 插入水平分割线。
将相关的变量定义和计算分组放在一起，用空行隔开不同逻辑部分。

4. 保存项目

操作：点击 “File” > “Save” (Cmd + S)。Calca文档默认保存为 .calca 扩展名的纯文本文件，其中包含了你的所有源代码。你也可以保存为普通的 .txt 或 .md 文件。

5. 导出最终文档

操作：点击菜单栏 “File” > “Export”，你可以选择导出格式：

HTML：生成一个包含完整格式和计算结果的独立网页。
PDF：生成PDF文档，便于打印和分享。
LaTeX：导出为LaTeX代码，用于学术出版。

在导出对话框中，你可以选择是否包含源代码（编辑区文本）。通常导出最终预览效果即可。

三、常用功能进阶技巧

范围定义与求和：你可以定义数字范围，并进行快速计算。例如：

x = [1 to 10] // 定义数组
= sum(x) // 计算总和，结果为55
= x^2 // 对每个元素进行平方计算

单位换算：Calca内置强大的单位系统。直接在计算中使用单位，如 = 60 miles / 1 hour to km/h， Calca会自动计算并转换。

条件逻辑：使用 if 语句进行条件计算。例如：

discount = 0.1
finalPrice = if price > 100 then price*(1-discount) else price

注释：使用双斜杠 // 添加单行注释，注释内容不会被计算。
聚焦模式：使用 Cmd + R 可以快速计算当前光标所在行或所选表达式的结果，并在编辑器内以浮动形式显示，无需查看右侧预览区。

四、常见问题与解决方案

Q1：输入表达式后，右侧预览区没有显示计算结果，只显示了原代码。
A：请检查表达式是否以等号 = 开头。如果没有等号，Calca会将其视为普通文本或变量定义行。变量定义行不需要等号开头。

Q2：如何引用之前定义的变量？
A：直接使用变量名即可。Calca的文档是自上而下顺序计算的，确保你引用的变量在其定义之后，或定义已被执行。你可以随时修改变量值，所有依赖它的计算结果会自动更新。

Q3：遇到“未定义变量”或计算错误。
A：首先检查变量名拼写是否正确。其次，检查是否有循环依赖（例如A = B+1, B = A*2）。Calca无法解析循环依赖，会导致计算失败。

Q4：希望将预览区的最终文档（不含代码）复制出来。
A：将光标定位到编辑区，使用快捷键 Cmd + Shift + C，这将复制“渲染后的文本”（即预览区内容）到剪贴板，而非源代码。

五、Calca for Mac 快捷键汇总表

功能	快捷键 (Mac)	说明
新建文档	Cmd + N	创建空白文档
打开文档	Cmd + O	打开已有文件
保存文档	Cmd + S	保存当前文档
导出文档	Cmd + E	打开导出对话框
切换编辑/预览焦点	Cmd +	在左右面板间切换
计算当前行/选区	Cmd + R	在编辑器内快速查看结果
复制渲染文本	Cmd + Shift + C	复制预览区内容（结果）
查找	Cmd + F	在文档内查找
替换	Cmd + Option + F	查找并替换
插入当前日期	Cmd + D	在光标处插入日期
插入当前时间	Cmd + T	在光标处插入时间
注释/取消注释行	Cmd + /	添加或移除双斜杠注释
放大文本	Cmd + +	增大编辑器字体
缩小文本	Cmd + –	减小编辑器字体