Some pointers on how to migrate from v1 to v2:

Queries

v2 does not have support for old-style queries (live queries) anymore. They have been replaced with Lua Integrated Query. Give the linked page a read, but generally there’s a few differences:

  1. Lua Integrated Queries tend to start with from index.tag "tag-name" instead of plain tag-name. This is a bit longer, but since whatever comes after from is a Lua expression, you can not just query Objects, you can query any Lua table as well in the same way.
  2. In the old query language, you access attribute simply by their name, this works in LIQ too, but stylistically it’s nicer to use either _.attribute, or to give the object you’re iterating over a name, using from page = index.tag "page", for instance.
  3. The = equals operator is == in Lua 😄


Templates

In v1 there were various types of templates:



Live templates are now better expressed by simply putting ${lua expressions} in text. Iterating and rendering queries using templates is generally done using the ${template.each(query[[...]], someTemplateExpression)} pattern.

Live Template Widgets can now be implemented using an event listener:
event.listen {
  name = "hooks:renderTopWidgets", -- or hooks:renderBottomWidgets
  run = function(e)
    return widget.new {
      markdown = "Showing up at the top"
    }
  end
}


See Widgets for some examples.

Snippets can be implemented using the slashcommand.define API:

slashcommand.define {
  name = "my-snippet",
  run = function()
    editor.insertAtCursor("Hello world!")
  end
}


See Slash for more examples.

Page templates still need to be figured out, you can chime in here.

Plugs

Many existing plugs should keep working, but some may need updating.
However, since Space Config is removed. You now specify the plugs you like to use with Space Lua + the config API:

config.set("plugs", {
  "github:joekrill/silverbullet-treeview/treeview.plug.js"
})


After which you run the Plugs: Update to download and/or update them. Plugs: Add has not been (re)implemented, so you have to do this in code.

Removed features

Certain features have been removed:

  • Online mode: v2 is sync mode only, meaning all your content will be synced into your browser. A simpler Online mode may be added back later. If you like to wipe your local content at any time, use the System: Wipe Client command.
  • Federation
  • Share replaced by Export
  • Libraries: will likely be replaced by Import.
  • Space Script: replaced by Space Lua
  • Space Config: replaced by the config APIs.
  • Command link syntax ({[...]})) replaced by the ${widgets.commandButton(...)} API.