Skip to content

✨ Add first-class sourced quotation blocks - #30

Merged
JFWooten4 merged 3 commits into
mainfrom
quotation-blocks
Sep 26, 2026
Merged

JFWooten4 merged 3 commits into
mainfrom
quotation-blocks

Conversation

@JFWooten4

@JFWooten4 JFWooten4 commented Sep 21, 2026 •

Copy link
Copy Markdown
Member

Summary

  • add a first-class QUOTE blockquote type
  • accept both SOURCE and SRC attribution markers
  • render the attribution as an italic, right-aligned em-dash citation
  • preserve inline Markdown, links, and ordinary document footnote references in quotation text and sources
  • support quote-local source footnotes whose original labels remain independent and may be discontinuous
  • render quote-local footnotes inside the quotation, between the quoted text and source attribution
  • inherit the existing configurable blockquote colors, backgrounds, borders, corner radius, and footnote typography
  • document the syntax and add CLI, web, typography, numbering, and rendered-PDF coverage

Basic syntax

> [!QUOTE]
> The important thing is not to stop questioning.
> [!SOURCE] Albert Einstein

[!SRC] is accepted as a case-insensitive shorthand for [!SOURCE].

Preserving source footnotes

> [!QUOTE]
> First quoted passage.[^4] Later quoted passage.[^17]
> [^4]: The source's original fourth footnote.
> [^17]: The source's original seventeenth footnote.
> [!SOURCE] Author, *Work*

The local labels 4 and 17 render unchanged inside the quotation and do not consume numbers from the document's ordinary sequential footnotes. Definitions outside the quotation retain the existing document-footnote behavior.

Why

Ordinary blockquotes do not distinguish quoted text, preserved source notes, and attribution. This syntax keeps those parts explicit in Markdown while producing a continuous professional quotation treatment in the PDF.

Validation

  • 119 tests pass
  • verified CLI and web PDF rendering
  • visually inspected discontinuous source notes 4 and 17 inside the quotation before the attribution
  • confirmed an ordinary document footnote remains independently numbered 1 in the page footer
  • confirmed source markers and local note definitions are omitted from literal PDF text

JFWooten4 and others added 2 commits September 21, 2026 11:40
Co-authored-by: Codex <noreply@openai.com>
Co-authored-by: Codex <noreply@openai.com>
@vercel

vercel Bot commented Sep 21, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
pdf Ready Ready Preview Sep 21, 2026 3:48pm UTC

Co-authored-by: Codex <noreply@openai.com>
@JFWooten4
JFWooten4 merged commit bebc617 into main Sep 26, 2026
2 checks passed
@JFWooten4
JFWooten4 deleted the quotation-blocks branch September 26, 2026 21:50

This branch was successfully deployed

1 active deployment
Preview — 87a5ba01 Deployed Sep 21, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant