zim1

Usage

Overview

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, --scores print score for each page
-w, --whole-word match whole words only
-c, --match-case match case sensitive
--sorted sort results either by name or by score

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

Convert Notebook Options !!!EXPERIMENTAL MAKE A BACKUP FIRST!!!:
--format change the source format and re-write all pages in
the new format ('zim-wiki', 'markdown')
--extension optional file extension for the new pages, defaults
to e.g. '.txt' for zim-wiki and '.md' for markdown

Try 'zim --manual' for more help.