feynlee / code-insertion

A Quarto extension to add markdown code immediately before and/or after the post.

Code-insertion Extension For Quarto

This is a Quarto extension that enables code insertion immediately before and/or after a post/page.

• When you insert code before the post, it will be after the post header (the section that contains the author and date).
• When you insert code after the post, it will be before the comment section.

Installing

quarto add feynlee/code-insertion

This will install the extension under the _extensions subdirectory. If you're using version control, you will want to check in this directory for your Quarto website.

Using

In the front matter of a post, the code-insertion filter and add insert-before-post and/or insert-after-post parameters that point to a markdown file with sections you want to insert before and/or after the post.

filters:
  - code-insertion
insert-before-post: before_post.md
insert-after-post: after_post.md

You need to specify the path to the markdown file that contains the code you want to insert into your post. Currently, this extension does not support inline code insertion (i.e. specifying the code to be inserted right within YAML front matter).

Tip: You can add this to _metadata.yml under the folder containing all your posts so that all of them can share this setting.

Example

Here is the source code for a minimal example: example.qmd.