Markdown Guide for Typora Overview Markdown was created by Daring Fireball; the original guide is available here. However, its syntax varies across different parsers and editors. Typora uses GitHub Flavored Markdown. Block Elements Paragraphs and Line Breaks A paragraph is one or more consecutive lines of text. In Markdown source, paragraphs are separated by two or more blank lines. In Typora, a single blank line (pressing Enter once) is enough to create a new paragraph. Press Shift + Enter to create a single line break. Most other Markdown parsers ignore single line breaks, so to ensure compatibility you can leave two spaces at the end of the line or insert <br/>. Headings Headings use 1–6 hash (#) characters at the start of the line, corresponding to heading levels 1–6. In Typora, type some hashes followed by the heading text and press Enter.

H1 Heading

H2 Heading

H6 Heading

Blockquotes Markdown uses email-style > characters for blockquotes. In Typora, typing > followed by your quoted content generates a blockquote. Typora inserts proper > symbols and line breaks. Nest blockquotes by adding extra > levels. > This blockquote has two paragraphs. First paragraph here. > > Second paragraph. Vestibulum enim wisi, viverra nec, fringilla in.

> Another blockquote with one paragraph. Three blank lines separate the two blockquotes.

Lists Typing * item creates an unordered list — * can be replaced by + or -. Typing 1. item creates an ordered list. The Markdown source looks like:

unordered list

• Red
• Green
• Blue

ordered list

1. Alpha
2. Beta
3. Gamma

Task Lists Task lists are lists with items marked as [ ] (incomplete) or [x] (complete). For example:

• a pending task
• list syntax required
• normal formatting, @mentions, #1234 refs
• not started
• finished

Fenced Code Blocks Typora supports fenced code blocks as in GitHub Flavored Markdown. Simply type ``` and press Enter. Optionally add a language identifier for syntax highlighting: Example:

function demo() {
  console.log("notice the blank line before this function?");
}

syntax highlighting:

require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html

Math Blocks You can render LaTeX math expressions using MathJax. To add a math block, type $$ and press Enter. This opens an input field for Tex/LaTeX source. A math block is wrapped by a pair of $$ markers: [\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \ \end{vmatrix} ] Tables Type | First Header | Second Header | and press Enter to create a two-column table. Once created, focusing on the table reveals a toolbar for resizing, aligning, or deleting. You can also use the context menu to copy and add/remove columns and rows. Full table syntax (Typora auto‑generates the Markdown source):

Footnotes You can create footnotes like this[^note]. Hover over the superscript to see the footnote content.

Horizontal Rules Typing *** or --- on an empty line and pressing Enter draws a horizontal line. YAML Front Matter Typora supports YAML front matter. Type --- at the top of the document and press Enter to introduce a metadata block. You can also insert it from the top menu. Table of Contents (TOC) Type [toc] and press Enter. This inserts a "Table of Contents" section. The TOC extracts all headings from the document and updates automatically as you edit. Inline Elements Links Markdown supports two link styles: inline and reference. In both styles, link text is delimited by square brackets []. To create an inline link, use a set of regular parentheses immediately after the link text’s closing bracket. Inside the parentheses, put the URL and an optional title in quotes: This is an example inline link.

This link has no title attribute.

This produces: This is an example inline link. This link has no title attribute. Internal Links You can set the href to a heading to create a bookmark that jumps to that section. For example: Command+click (on Windows: Ctrl+click) on this link jumps to the heading "Block Elements". To see the source, move the cursor or click the link and press ⌘ to expand the element. Reference Links Reference-style links use a second set of square brackets containing a label to identify the link: This is an example reference-style link.

Then, anywhere in the document, define the link label on its own line:

In Typora they render as: This is an example reference-style link. Implicit link name shortcuts let you omit the label, using the link text itself as the name. Just use empty square brackets: GoogleThen define the link:

In Typora, clicking a link expands it for editing; Command+click opens the hyperlink in your web browser. URLs Typora allows you to insert URLs as links, wrapped in angle brackets <>. <i@typora.io> becomes i@typora.io. Typora also auto‑links standard URLs, e.g. www.google.com. Images Image syntax is similar to links with an extra ! character before the opening bracket:

You can insert images by dragging from a file or web browser. Click an image to modify its Markdown source. Images dragged from the same directory or a subdirectory will use relative paths. For website building, you can set a typora-root-url in YAML front matter to specify a URL prefix for image previews on your local machine. E.g., typora-root-url: /User/Abner/Website/typora.io/ makes behave as . Emphasis Markdown treats asterisks (*) and underscores (_) as emphasis indicators. Text wrapped in one * or _ is wrapped in HTML <em> tags: single asterisks

single underscores

Output: single asterisks single underscores Bold Double asterisks or double underscores will wrap content in <strong> tags: double asterisks

double underscores

Output: double asterisks double underscores Code To indicate inline code, wrap it with backticks (). Unlike preformatted code blocks, a code span denotes code within a normal paragraph: Use the display()` function.

produces: Use the display() function. Strikethrough GFM adds strikethrough syntax: Mistaken text. becomes Mistaken text. Underline Underline is supported via raw HTML: <u>Underline</u> becomes Underline. Emoji 😄 Use the syntax :smile: to insert emoji. Autocompletion suggestions can be triggered by pressing ESC or enabled automatically in preferences. You can also directly input UTF-8 emoji characters from Edit → Emoji & Symbols (macOS). Inline Math Enable inline math in Preferences → Markdown tab. Then use $ to wrap TeX commands. Example: $\lim_{x \to \infty} \exp(-x) = 0$ will render as a LaTeX command. To trigger inline preview: type $, press ESC, then enter the TeX command. Subscript Enable in Preferences → Markdown, then use ~ to wrap subscript content: H2O, Xlong\ text. Superscript Enable similarly, then use ^ to wrap superscript content: X^2^. Highlight Enable the feature, then use == to wrap highlighted text: ==highlight==. HTML You can use HTML to style content beyond plain Markdown. For instance, <span style="color:red">this text is red</span> adds red text. Embedded Content Some websites provide iframe-based embed codes that can be pasted into Typora. Example: <iframe height='265' scrolling='no' title='Fancy Animated SVG Menu' src='http://codepen.io/jeangontijo/embed/OxVywj/?height=265&theme-id=0&default-tab=css,result&embed-version=2' frameborder='no' allowtransparency='true' allowfullscreen='true' style='width: 100%;'></iframe>

Video You can embed videos using the HTML <video> tag: <video src="demo.mp4" />

Other HTML Support More details can be found here.