zim - Man Page

A Desktop Wiki Editor

Synopsis

usage: zim [Options] [NOTEBOOK [PAGE_LINK]]
  or: zim --gui [Options] [NOTEBOOK [PAGE_LINK]]
  or: zim --server [Options] [NOTEBOOK]
  or: zim --export [Options] NOTEBOOK [PAGE]
  or: zim --import [Options] NOTEBOOK PAGE FILES
  or: zim --search [Options] NOTEBOOK QUERY
  or: zim --index  [Options] NOTEBOOK
  or: zim --plugin PLUGIN [ARGUMENTS]
  or: zim --manual [Options] [PAGE_LINK]
  or: zim --help

NOTEBOOK can be a local file path, a local file URI or a notebook name PAGE is be a fully specified page name PAGE_LINK is a fully specified page name optionally extended with an anchor ID

Description

Zim is a graphical text editor used to maintain a collection of wiki pages. Each page can contain links to other pages, simple formatting, and images. Pages are stored in a folder structure, like in an outliner, and can have attachments. Creating a new page is as easy as linking to a nonexistent page. All data is stored in plain text files with wiki formatting. Various plugins provide additional functionality, like a task list manager, an equation editor, a tray icon, and support for version control.

Zim can be used to:

Options

General Options:
 --gui             run the editor (this is the default)
 --server          run the web server
 --export          export to a different format
 --import          import one or more files into a notebook
 --search          run a search query on a notebook
 --index           build an index for a notebook
 --plugin          call a specific plugin function
 --manual          open the user manual
 -V, --verbose     print information to terminal
 -D, --debug       print debug messages
 -v, --version     print version and exit
 -h, --help        print this text

GUI Options:
 --list            show the list with notebooks instead of
                   opening the default notebook
 --geometry        window size and position as WxH+X+Y
 --fullscreen      start in fullscreen mode
 --non-unique      start a new process, do not connect to an existing process
 --standalone      start a new process per notebook, implies --non-unique

Server Options:
 --port            port to use (defaults to 8080)
 --template        name or filepath of the template to use
 --private         serve only to localhost
 --gui             run the gui wrapper for the server

Export Options:
 -o, --output      output directory (mandatory option)
 --format          format to use (defaults to 'html')
 --template        name or filepath of the template to use
 --root-url        url to use for the document root
 --index-page      index page name
 -r, --recursive   when exporting a page, also export sub-pages
 -s, --singlefile  export all pages to a single output file
 -O, --overwrite   force overwriting existing file(s)

Import Options:
 --format          format to read (defaults to 'wiki')
 --assubpage       import files as sub-pages of PATH, this is implicit true
                   when PATH ends with a ":" or when multiple files are given

Search Options:
 -s, --with-scores print score for each page, sort by score

Index Options:
 -f, --flush       flush the index first and force re-building

Try 'zim --manual' for more help.

Author

Jaap Karssenberg <jaap.karssenberg@gmail.com>

See Also

The full documentation for zim is maintained as a zim notebook. The command

zim --manual

should give you access to the complete manual.

The website for zim can be found at https://www.zim-wiki.org

Info

February 2025 zim 0.76.1