MarkDown
========

(c) 2026 R. F. Windley & The Really Small Software Company


MarkDown is a Markdown editor and viewer for the RISC OS desktop.

Main features are:

- Edits the Markdown source exactly as written, so files are saved unchanged
- A live preview window that wraps the formatted document to its width
- Headings, emphasis, code, links, images, lists, task lists, block quotes,
  code blocks, rules and tables
- Mermaid diagrams (```mermaid code blocks) drawn in the preview
- Toolbar, Format menu and keyboard shortcuts for common Markdown markup
- Undo and redo, and the global clipboard
- Export to HTML and to Ovation Pro DDL


Using MarkDown
--------------

Click on the iconbar icon to create a new document, or drag a Text file onto
it. Double-clicking a file whose name ends in /md or /markdown opens it in
MarkDown.

Click Preview on the toolbar (or press Ctrl-P) to open the preview window.
The preview updates as you type. Click a link in the preview to open it;
double-click a paragraph to jump to its source in the editor.

A fenced code block whose info word is mermaid is drawn as a diagram in
the preview, using MermaidLib (the same renderer as !Mermaid). Diagrams
are shrunk to fit narrow windows. HTML export writes them as
<pre class="mermaid"> blocks, which mermaid.js can draw.
Export DDL embeds each diagram as a Draw picture in the story.

Drag a file into the editor to insert it at the pointer; hold Shift to
insert its name instead.


Keys

  F1            Help
  F3            Save
  Shift-F3      Export HTML
  Ctrl-F3       Export Ovation Pro DDL
  F8 / Ctrl-Z   Undo
  F9            Redo
  Ctrl-X/C/V    Cut, copy and paste
  Ctrl-A        Select all
  Ctrl-B        Bold
  Ctrl-E        Italic
  Ctrl-K        Link
  Ctrl-L        Bulleted list
  Ctrl-N        Numbered list
  Ctrl-P        Preview
  Shift-Left/Right       Previous/next word
  Ctrl-Left/Right        Start/end of line
  Ctrl-Up/Down           Start/end of document
  Ctrl-Shift-cursor keys Extend the selection

Pressing Return in a list or block quote continues it; Return on an empty
list item ends the list.


Fonts
-----

The fonts and sizes used are set in Resources.Messages (FontEdit, FontBody,
SizeBody and so on). Sizes are in 1/16 point.
