@suzu-sys/notion-eq v1.1.14

Notion-Eq

An equation numbering tool for Notion.

• Automatically adds equation numbers to LaTeX blocks in Notion documents.
• Automatically replaces equation references with corresponding numbers (similar to LaTeX's \eqref).

Getting Started

Prepare Your Notion Environment

1. Obtain an integration token.

2. Identify the Notion page you want to process and get its Page ID.

3. Set up the AlignEqRefs database and get its Database ID.

Setup

Create a .env file in the current directory and add the following:

NOTION_TOKEN=*********************
PAGE_ID=*********************
ALIGN_EQ_REFS_DB_ID=*********************

Installation (Optional)

npm i -g @suzu-sys/notion-eq
# OR use it via npx (no installation required)

Usage

1. Add Equation Numbers

Use \tag{} or \tag{<digits>} in your LaTeX blocks to mark equations for numbering. Any digits you enter will be overwritten with the correct number automatically.

• Equation block with a single \tag{}:

  x^2 + 2x + 1 \tag{}

• Equation block with multiple \tag{}s:

  \begin{align}
  \mathbf U^T\mathbf \Sigma^{-1}\mathbf U &= \mathbf\Lambda\tag{} \\
  \mathbf\Sigma^{-1} &= \mathbf U\mathbf\Lambda\mathbf U^T\tag{}
  \end{align}

2. Reference Equations

To reference a numbered equation, insert a link to the equation block from a text block. The link title does not affect numbering.

If the equation block contains multiple \tag{}s, register the referencing text block in the AlignEqRefs database.

3. Run the Tool

# If installed:
notion-eq
# OR use npx:
npx @suzu-sys/notion-eq

Example Output

• Before
• After

.env Parameters

!NOTE
EQ_PREFIX and EQ_SUFFIX apply only to how equation numbers appear in text blocks, not in LaTeX blocks.

Page and database IDs are 32-character alphanumeric strings, found at the end of a Notion page or database URL.

AlignEqRefs Database

The AlignEqRefs database is used to handle references to individual equations within an equation block that contains multiple \tag{}s.

!NOTE
Example
ref(U,0) and ref(U,1) refer to individual equations within a block that has multiple \tag{}s.
ref(x^2) refer to a block with only a single \tag{}.
If a text block contains:
"... ref(U,0) ... ref(x^2) ... ref(U,1) ..."
then the Index field should be "0,1".
Links to single-tag blocks (like ref(x^2)) are ignored when determining the order.