Unmarked# Unmarked Guides
Learn Markdown
Start from zero or look up one piece of syntax, and see exactly how Unmarked renders it.
Markdown basics
- Markdown cheat sheetA one-page Markdown cheat sheet: headings, bold, lists, links, code, tables, and more, with the exact syntax and what each renders as in Unmarked.
- What is a .md file?A .md file is a plain text file that contains Markdown. Open it in any text editor; the extension just tells apps to treat it as Markdown.
- Markdown, explained simplyMarkdown is plain text with a few simple marks, like # for a heading and ** for bold, that turn into formatting when an app renders the file.
Syntax
- Markdown blockquotes and horizontal rulesHow to write blockquotes and horizontal rules in Markdown: a greater-than sign quotes a line, three dashes draw a divider. With nesting and examples.
- Bold, italic, and strikethrough in MarkdownHow to write bold, italic, and strikethrough in Markdown: double asterisks for bold, single for italic, double tildes for strikethrough.
- Code in Markdown: inline and fenced blocksInline code uses single backticks; a fenced code block uses three backticks on their own lines, with an optional language name. How to write both.
- YAML frontmatter in MarkdownYAML frontmatter is a metadata block at the top of a Markdown file, fenced by three dashes, holding key-and-value pairs like title, date, and tags.
- Markdown headingsMarkdown headings use one to six hash marks at the start of a line for six levels, from # H1 down to ###### H6. Syntax, examples, and how Unmarked renders them.
- Markdown links and imagesMarkdown link and image syntax explained: square brackets for text, parentheses for the URL, and a leading exclamation mark turns a link into an image.
- Markdown lists: bullets, numbers, and nestingHow to write Markdown lists: a dash, asterisk, or plus for bullets, a number and period for ordered lists, and indenting to nest.
- Markdown tablesMarkdown table syntax: separate columns with pipes, add a dashed row under the header, and use colons to set column alignment. Examples and what renders.
- Markdown task lists and checklistsHow to write a Markdown task list: a bullet, then square brackets. Empty brackets are unchecked, brackets with an x are checked. A GitHub extension.
Use cases
- How to read a README file on MacA README is a Markdown file. To read it rendered instead of as raw text, open it in Unmarked: double-click in Finder or press Open.
- How to write a changelog in MarkdownWrite a changelog in Markdown using the Keep a Changelog convention: versions newest-first, each dated and grouped under Added, Changed, Fixed, Removed.
- How to write a README in MarkdownHow to write a README in Markdown: the sections most have (title, description, install, usage, license), a copyable skeleton, and how it renders in Unmarked.
- Markdown meeting notes templateA simple, reusable Markdown meeting-notes template: date, attendees, agenda, notes, decisions, and action items as a checklist you can tick off.
- View ChatGPT and Claude Markdown output on MacChatGPT and Claude write in Markdown. Save the answer as a .md file and open it in Unmarked to see real headings, lists, tables, and code blocks.
- Writing documentation in MarkdownHow to structure a documentation page in Markdown: a clear heading hierarchy, short sections, fenced code for examples, tables for reference, and links.
Standards
Didn’t find it?
A real person reads every message. Contact us.