Draftist Docs

Basics

All the standard Markdown you know and love works out of the box. Here's a quick rundown.

Headings

Use ## through ###### for levels 2–6. H1 is reserved for the page title, so start at H2. On doc pages, headings automatically generate the table of contents.

Paragraphs

Plain text separated by blank lines — nothing special here.

Inline Formatting

  • **bold** — bold
  • _italic_ — italic
  • ~~strikethrough~~ — strikethrough
  • `inline code` — inline code

You can nest these too: **_bold italic_** → bold italic.

Links

External Links

Standard Markdown links — nothing fancy:

md
[Draftist](https://draftist.io)

Internal Links

Link to other pages on your site using the same standard Markdown:

md
[Link text](Page Title)
[Deep link text](Page Title#^block-id)

Draftist requires standard Markdown links, not [[wiki-link]] syntax. Make sure "Use [[Wikilinks]]" is turned off in Obsidian's settings (Settings → Files and links).

The plugin resolves internal links during publishing and checks that target pages exist. Deep links (using #^block-id) point straight to a specific element on the page.

Draftist also checks whether linked content is available on the live site. When publishing content that links to unpublished, archived, deleted, or missing content, you'll see a warning. You can publish anyway, but the affected links will be broken until the target content is published.

When making published content unavailable, Draftist checks whether other live content links to it and asks you to review those links before continuing.

Lists

Unordered Lists

md
- First item
- Second item
  - Nested item

Ordered Lists

md
1. First item
2. Second item
   1. Nested item

Ordered lists support custom start numbers. You can mix ordered and unordered when nesting, and go as deep as you like.

Horizontal Rules

Drop ---, ***, or ___ on its own line for a thematic break between sections.