Consult the editor and panel controls, Properties and Resources fields and choices in Markdown Documents dialogs.
Toolbars and panels
| Command or field | Location, use and result |
|---|---|
| Document / status | The line above the editor identifies the current Dataset or shows New document, indicates whether the draft has changed, and shows which save action is available. Check it again after each operation. |
| Find | In the Find field, type a literal string to search in the source. |
| Previous | The Previous button next to Find looks for the previous match; Shift+F3 offers the same direction. |
| Next | The Next button next to Find looks for the next match; F3 offers the same direction. |
| Replace with | In the Replace with field insert the replacement text; it is visible when the replacement is active. |
| Replace | The Replace button replaces the current match with Replace with. |
| Replace all | The Replace all button replaces all matches; check the search first. |
| Line numbers | The left margin identifies the rows; the shared lane has a context menu with breakpoint operations and folding. |
| Scrollbars | Drag the vertical and horizontal bars of the source or those of the Preview to explore long lines and text. |
| Pane divider | Drag the divider between panels to redistribute the space; Reset Layout restores the layout. |
| Outline | In Outline selects a title to bring the cursor to the line in the source. |
| Properties | Properties reports Canonical Dataset, Producer, Baseline SHA256, source association, Save Existing, Destination and Unsaved changes; use it to verify identity and conditions before saving. |
| Resources | Resources lists Image, Bytes and Dimensions. Select a line to read Target, SHA256, Bytes, Dimensions and Media. |
| Add | In Resources use Add and choose a regular PNG to add a resource and its reference to the source. |
| Replace image | In Resources, select an image and choose Replace to select a new PNG under the same logical name. Check the updated dimensions and SHA-256 hash. |
| Remove image | In Resources, select an image and choose Remove. Review any remaining references to that image in the source. |
| Description / History | In the bottom strip choose Description for the state or History for the timeline of the states; Details opens the full text. |
| Details | The Details button on the strip opens the details of the selected mode, read only. |
Source gutter
| Command or field | Location, use and result |
|---|---|
| Toggle breakpoint | Right click in the margin → Toggle breakpoint attempts to activate or remove the point on the line; an unexecutable Markdown line can be rejected. |
| Enable breakpoint | In the Enable breakpoint margin menu, it enables an existing point on the line; the control is shared with code editors. |
| Disable breakpoint | In the gutter context menu, choose Disable breakpoint to disable the breakpoint on the current line while keeping it in place. |
| Remove breakpoint | In the Remove breakpoint margin menu removes the line point. |
| Clear all breakpoints | In the Clear all breakpoints margin menu removes all surface points; Ctrl+Shift+F9 recalls the same function. |
| Fold / unfold current block | In the Fold/unfold current block menu folds or reopens a recognized block; availability depends on the detected structure. |
| F9 | With focus in the source editor, F9 attempts to toggle the breakpoint on the current line. |
Properties and Resources fields
| Command or field | Location, use and result |
|---|---|
| Canonical Dataset | In Properties indicates the ID of the associated Dataset; (none) means draft without canonical dataset. |
| Producer | In Properties indicates the producer module of the Dataset; it is relevant for the possibility to replace it. |
| Baseline SHA256 | In Properties, this is the hash of the baseline revision loaded into the editor. Save Existing compares it before writing. |
| Source filename | In Properties shows the relative name of the associated source file, when present. |
| Language | In Properties indicates the language of the associated source, for example python. |
| Project name | In Properties shows the name of the project when the association provides it. |
| Project ID | In Properties shows the identification of the project when the association provides it. |
| Associated source | In Properties reports if the document has an associated source; an associated note may show file name and diagnostics. |
| Source status | In Properties indicates the status of the associated source: current confirms identity and revision; revised signals a different revision and the note remains readable; renamed signals the same identity with another name; indicates that the owner or source file is not accessible. Read Explanation and review the source before editing or saving. |
| Source SHA256 | In Properties, this is the hash of the associated source. Compare it when reviewing a revision. |
| Source owner | In Properties identifies the type of owner of the associated source, for example python_script. |
| Explanation | In Properties describes the reason for the association’s status with the source. |
| Save Existing status | In Properties indicates whether the update is authorized or unavailable; the authorization is checked when saved. |
| Destination | In Properties shows the chosen destination ID for publication. |
| Unsaved changes | In Properties the 1 value indicates unsaved changes compared to the base; 0 indicates no changes detected. |
| Image | In Resources the Image column identifies the logical name of the selectable resource. |
| Bytes | In Resources Bytes indicates the size of the resource in bytes. |
| Dimensions | In Resources Dimensions indicates width × pixel height. |
| Target | In the selected resource details, Target shows the relative assets/ reference used in the Markdown source. |
| SHA256 | In the selected resource details, SHA256 is the hash of the managed resource bytes. |
| Media | In the detail of the selected resource Media indicates the type, for example image/png. |
Dialog fields and choices
| Command or field | Location, use and result |
|---|---|
| Name | In the New, Rename, Save As or Save History As form, enter the requested name. Apply validation and apply; Close leaves the module without applying. |
| Name / Count / Cursor | In Named History the columns indicate the name, number of operations and location of the named history; select the row before the actions. |
| Yes — modified draft | When prompted to save before New or Open, Yes starts the appropriate save action; if the draft is not completed, it remains open. |
| No — modified draft | When prompted to save before New or Open, No discard current changes and continue with the required command. |
| Cancel — modified draft | Upon save prompt before New or Open, Cancel cancels the command and retains the current draft. |
| OK — Dataset selection | In the Open Dataset selector, choose an ID between the Session’s Dataset Markdown and confirm with OK. |
| Cancel — Dataset selection | In the Open Dataset selector, Cancel closes the choice without opening another Dataset. |
| Dataset ID — Publish New | In the Publish New dialog, enter a valid and unused canonical ID; the confirmation publishes a new Dataset and a duplicate ID is refused. |
| Source / Rendered Preview | By initial setting are visible source and Preview: the first is editable, the second shows the rendered result of the draft. |
| Outline / Properties / Images | By initial setting they are hidden; the respective View commands show them. Reset Layout returns to this set of panels. |
| Text limit | Editable source must contain valid UTF-8 without NUL bytes and be no larger than 4 MiB. Larger documents do not open as editable drafts. |
| Image limit | The managed images are PNG, up to 4 MiB each, maximum 32 and 16 MiB overall. After Remove or New consult the warning in the Images chapter. |
| Text scale | The initial scale is 1.0. Actual Text Size restores it to 1.0. F7 and F8 change it by 0.25 per step within the range 0.5–3.0. |