Live blocks
Change the numbers once. Every document that shows them follows.
A live block is part of a document that comes from another file: a spreadsheet’s table in a Word report, a total in the middle of a sentence, a drawing in a note. When the source changes, Golem Docs writes the new result into every document that shows it.
Garden plan
Four new beds along the south fence this spring. So far they have cost $214.
What each part cost, from the budget:
| Item | Cost |
|---|---|
| Seeds | $38 |
| Soil and compost | $96 |
| Cedar boards | $80 |
| Bean trellis | $45 |
| Total | $214 |
| A | B | C | |
|---|---|---|---|
| 1 | Item | Cost | |
| 2 | Seeds | $38 | |
| 3 | Soil and compost | $96 | |
| 4 | Cedar boards | $80 | |
| 5 | |||
| 6 | Total | $214 | |
| 7 |
Make one in three steps
- Copy as Live Link. In a spreadsheet, select a table, a range or one cell and choose Edit › Copy as Live Link. It works in documents too, for a table, a section or a bookmark.
- Paste it anywhere. Into a Word document, a note, another spreadsheet, a PDF form or a drawing. It shows what the source shows, with the source’s number formats, in the style of the document around it.
- Keep working. Change the source and every document that shows it is updated, in order, even a document that shows a document that shows it. A change that doesn’t touch a block writes nothing.
The result is in the file.
## Spring costs <!-- golem:live Garden budget.xlsx#Spring stamp=3f9a2c1e --> | Item | Cost | | --- | ---: | | Seeds | $38 | | Soil and compost | $128 | | Cedar boards | $80 | | Bean trellis | $45 | | Total | $291 | <!-- /golem:live -->An ordinary table to every other app
A live block writes what it shows into the document itself. Word, Obsidian, GitHub and your ai all see an ordinary table, with numbers that are current.
In a note, typing ![[Garden budget.xlsx#Spring]] makes one, so your ai can add a live block by writing a single line, and Golem Docs fills it in.
Any source, in any document
What a block can show
- .xlsxA table, a range, a named cell or a chart
- .csvA whole file, filtered and sorted
- .docx .mdA section, a bookmark or a table of another document
- .mdA field from a note’s front matter
- .pdfA form field’s value, or a page as a picture
- .svg .pngA drawing or a picture
Where it can go
- .docx .odtWord and OpenDocument: a table, a value in a sentence, a picture
- .md .htmlNotes and web pages
- .xlsxSpreadsheets: the cells fill from where you paste, and formulas can use them
- .pdfPDF forms and pages: a field filled in, a text box, a picture
- .svgDrawings: a group you can move and scale
- .pdfA PDF copy of a document, written again whenever the document changes (File › Live PDF Copy)
Blocks that need no spreadsheet
Insert › Live Block works things out from a folder of notes, with no formulas and no code.
| Name | Role | Status |
|---|---|---|
| Mara Voss | captain | aboard |
| Tobin Reyes | cook | aboard |
| Old Wen | mapmaker | missing |
| Pip | stowaway | aboard |
Words in Novel
41,200 / 50,000 words
1,140 today
There’s also a timeline of notes by a date in their front matter. For anything else, there are scripts: a small TypeScript file in your vault, written by you or your ai, that runs in a sandbox and sees only what you allow.
Built to be trusted
- No code in your documents. A document names where a block comes from and holds its last result. Sharing it shares no code, unlike Office macros.
- Nothing is lost. If a source goes missing or can’t be read, the block keeps its last result and says why.
- Someone else’s blocks don’t read your files. A form someone sends you keeps what it came with, until you choose Make It Mine.
- It happens on your devices. The app that saves a change updates what depends on it, on the web, on your computer or on your phone. Your ai’s edits to the folder count too.
- No ai needed. Every block can be made, set up and updated from the menus.