Quoth Plugin

This a plugin for Obsidian
that allows embedding from other markdown files
with greater flexibility than the standard embed syntax.

It allows:

• Embedding parts of a single block
• Embedding multiple parts in one "quote"
• Inlining the embed so it aligns with other content
• Automatically adding source author and title to the embed

Copying References

The simplest way to use the plugin is to use the copy reference command.
This will take a selection from source mode or preview mode
and copy a qouth code block into your clipboard
that can be pasted in other documents.
The hotkey for this is either Ctrl-Shift-' or Cmd-Shift-' depending on your OS.

Code Blocks

Code blocks can also be constructed manually, and some functionality requires it.
All the fields in the code block can be seen below:

```quoth
path: [[Filename#Heading]]
ranges: "Hello " to "world.", "Foobar" to "Bizzbaz"
join: " -- "
display: inline
show: author, title
```

Fields

path

Syntax: [[filename#subpath]]

subpath syntax:

• A heading: #Some heading
• A block id: #^blockid
• A list item: #-Some list item

Default: None

Description: Required. The path to the content you want to include,
formatted like an obsidian link. Additionally supports specifying a list
item. Multiple headings or multiple list items can be chained in the subpath.

ranges

Syntax: range, range

range syntax:

• "text" to "text"
• "whole quote"
• line:col to line:col
• after "text"
• after line:col

Default: None

Description: A subselection of the path you would like to embed.
Multiple ranges are joined by ,.

join

Syntax: "string"

Default: " ... "

Description: How to combine multiple ranges.
This field is only used if there are 2 or more ranges specified.

display

Syntax:

• embedded
• inline

Default: embedded

Description: How to display the embed.

show

Syntax: option, option

options:

• author
• title

Default: None

Description: Whether to include the source author or title.
Multiple options can be joined with ,.

Deprecated Fields

Limitations

There are currently some limitations to the current implementation:

• Copying from preview mode only works if the underlying markdown can be
  reconstructed.
  Things like mathjax are not currently handled.
  You can always copy from source/live mode.
• The embedded content cannot contain another quoth code block,
  because that could lead to infinite recursion.
• Rendering relies on an async call to Obsidian's renderMarkdown API,
  so embeds relying on postprocessing (like other embeds) will not work.
• It is for display only. It cannot do things that would update the
  original source, like checking checkboxes.