Before you start
- Exploratory Desktop is running and the project is open (Choose a project). Check with expl status.
- You have the ids of the charts and analytics to embed (expl chart list <dataframe_id> and expl analytics list <dataframe_id>).
- note add and note edit work only when Allow create, edit and delete is on in System Settings > MCP / CLI. They do not ask for confirmation; deleting a note does. See Confirmation and long-running operations.
Steps
1. Write the body
Write the body in a Markdown file, report.md. To embed a chart or an analytics, put an embed tag such as {{chart:<chart_id>}} on a line of its own, with a blank line before and after it.2. Create the note
--title and --markdown are required. @file reads the long text from a file (Pass arguments and JSON).
--folder puts the note in an existing folder, and --settings takes a JSON object of the note settings (the table of contents and so on).
3. Add to it or rewrite it
--mode replace replaces the whole body. --title renames the note. To find an id, run expl note list.
4. Read it back
If it fails
For the arguments of any command, run
expl <command> --help or expl tools describe "<command>".
