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 --search 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
 --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
 --standalone     start a single instance, no background process

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)

Search Options:
 None

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

January 2024 zim 0.75.2