Publishing markdown

Publishing markdown

View as markdown

Publish it as it is. A markdown file — notes, a README, a write-up — is shown to people as a page: set in a reading measure, light or dark as their system is, with its tables, lists, code and links, and the crate and comments like anything else here. Its title is the front matter's title, or else its first heading.

Published with a theme — your assistant names one, or 23a publish notes.md --theme <theme> — it is set in that theme's colours and type instead, as a page made with it would be.

Assistants and programs reading the same address get the file as written, so it stays easy to fetch and change. Raw HTML inside the markdown shows as text, apart from a few harmless tags such as <br>, <sup>, <kbd> and <details>; for a page with a look of its own, ask your assistant for a page instead.