Fields, panels and dialogs

Consult the editor and panel controls, Properties and Resources fields and choices in Markdown Documents dialogs.

Toolbars and panels

Command or fieldLocation, use and result
Document / statusThe 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.
FindIn the Find field, type a literal string to search in the source.
PreviousThe Previous button next to Find looks for the previous match; Shift+F3 offers the same direction.
NextThe Next button next to Find looks for the next match; F3 offers the same direction.
Replace withIn the Replace with field insert the replacement text; it is visible when the replacement is active.
ReplaceThe Replace button replaces the current match with Replace with.
Replace allThe Replace all button replaces all matches; check the search first.
Line numbersThe left margin identifies the rows; the shared lane has a context menu with breakpoint operations and folding.
ScrollbarsDrag the vertical and horizontal bars of the source or those of the Preview to explore long lines and text.
Pane dividerDrag the divider between panels to redistribute the space; Reset Layout restores the layout.
OutlineIn Outline selects a title to bring the cursor to the line in the source.
PropertiesProperties reports Canonical Dataset, Producer, Baseline SHA256, source association, Save Existing, Destination and Unsaved changes; use it to verify identity and conditions before saving.
ResourcesResources lists Image, Bytes and Dimensions. Select a line to read Target, SHA256, Bytes, Dimensions and Media.
AddIn Resources use Add and choose a regular PNG to add a resource and its reference to the source.
Replace imageIn 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 imageIn Resources, select an image and choose Remove. Review any remaining references to that image in the source.
Description / HistoryIn the bottom strip choose Description for the state or History for the timeline of the states; Details opens the full text.
DetailsThe Details button on the strip opens the details of the selected mode, read only.

Source gutter

Command or fieldLocation, use and result
Toggle breakpointRight click in the margin → Toggle breakpoint attempts to activate or remove the point on the line; an unexecutable Markdown line can be rejected.
Enable breakpointIn the Enable breakpoint margin menu, it enables an existing point on the line; the control is shared with code editors.
Disable breakpointIn the gutter context menu, choose Disable breakpoint to disable the breakpoint on the current line while keeping it in place.
Remove breakpointIn the Remove breakpoint margin menu removes the line point.
Clear all breakpointsIn the Clear all breakpoints margin menu removes all surface points; Ctrl+Shift+F9 recalls the same function.
Fold / unfold current blockIn the Fold/unfold current block menu folds or reopens a recognized block; availability depends on the detected structure.
F9With focus in the source editor, F9 attempts to toggle the breakpoint on the current line.

Properties and Resources fields

Command or fieldLocation, use and result
Canonical DatasetIn Properties indicates the ID of the associated Dataset; (none) means draft without canonical dataset.
ProducerIn Properties indicates the producer module of the Dataset; it is relevant for the possibility to replace it.
Baseline SHA256In Properties, this is the hash of the baseline revision loaded into the editor. Save Existing compares it before writing.
Source filenameIn Properties shows the relative name of the associated source file, when present.
LanguageIn Properties indicates the language of the associated source, for example python.
Project nameIn Properties shows the name of the project when the association provides it.
Project IDIn Properties shows the identification of the project when the association provides it.
Associated sourceIn Properties reports if the document has an associated source; an associated note may show file name and diagnostics.
Source statusIn 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; unavailable indicates that the owner or source file is not accessible. Read Explanation and review the source before editing or saving.
Source SHA256In Properties, this is the hash of the associated source. Compare it when reviewing a revision.
Source ownerIn Properties identifies the type of owner of the associated source, for example python_script.
ExplanationIn Properties describes the reason for the association’s status with the source.
Save Existing statusIn Properties indicates whether the update is authorized or unavailable; the authorization is checked when saved.
DestinationIn Properties shows the chosen destination ID for publication.
Unsaved changesIn Properties the 1 value indicates unsaved changes compared to the base; 0 indicates no changes detected.
ImageIn Resources the Image column identifies the logical name of the selectable resource.
BytesIn Resources Bytes indicates the size of the resource in bytes.
DimensionsIn Resources Dimensions indicates width × pixel height.
TargetIn the selected resource details, Target shows the relative assets/ reference used in the Markdown source.
SHA256In the selected resource details, SHA256 is the hash of the managed resource bytes.
MediaIn the detail of the selected resource Media indicates the type, for example image/png.

Dialog fields and choices

Command or fieldLocation, use and result
NameIn 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 / CursorIn Named History the columns indicate the name, number of operations and location of the named history; select the row before the actions.
Yes — modified draftWhen prompted to save before New or Open, Yes starts the appropriate save action; if the draft is not completed, it remains open.
No — modified draftWhen prompted to save before New or Open, No discard current changes and continue with the required command.
Cancel — modified draftUpon save prompt before New or Open, Cancel cancels the command and retains the current draft.
OK — Dataset selectionIn the Open Dataset selector, choose an ID between the Session’s Dataset Markdown and confirm with OK.
Cancel — Dataset selectionIn the Open Dataset selector, Cancel closes the choice without opening another Dataset.
Dataset ID — Publish NewIn 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 PreviewBy initial setting are visible source and Preview: the first is editable, the second shows the rendered result of the draft.
Outline / Properties / ImagesBy initial setting they are hidden; the respective View commands show them. Reset Layout returns to this set of panels.
Text limitEditable 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 limitThe 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 scaleThe 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.