Skip to content

chore: prepare release 0.7.0 - #118

Merged
eitsupi merged 1 commit into
mainfrom
release/0.7.0
Nov 14, 2026
Merged

eitsupi merged 1 commit into
mainfrom
release/0.7.0

Conversation

@eitsupi

@eitsupi eitsupi commented Nov 14, 2026

Copy link
Copy Markdown
Owner

Summary

  • Bump the workspace and internal dependency versions from 0.6.0 to 0.7.0.
  • Finalize CHANGELOG as [0.7.0] - 2026-11-14 and retain an empty [Unreleased] section.
  • Update the five workspace package versions in Cargo.lock through Cargo, preserving all third-party dependency resolutions.
  • Run snapshot checks through cargo-insta; no snapshot changes are required.

Verification

  • cargo check --workspace --all-features
  • RD2QMD_REQUIRE_PANDOC=1 cargo insta test --accept --workspace --all-features --all-targets
  • cargo test --workspace --all-features --doc
  • cargo clippy --workspace --all-targets --all-features -- -D warnings
  • cargo fmt --all --check
  • cargo-dist 0.34.0 dist plan --output-format=json selects v0.7.0 and the rd2qmd 0.7.0 release.
  • rd2qmd --version reports rd2qmd 0.7.0.

Changelog

[0.7.0] - 2026-11-14

Added

  • Add the quarto-definition-list description list format (DescribeFormat::QuartoDefinitionList), which writes Quarto's ::: {.definition-list} div. Quarto 1.11.7+ and q2 render it as a definition list. (feat!: add the quarto-definition-list describe format #114)

    • Breaking: DescribeFormat gains the QuartoDefinitionList variant, and WriterOptions gains a definition_list_syntax field (DefinitionListSyntax::Pandoc by default). Exhaustive matches and struct literals must handle them, for example with ..Default::default().
  • Expose rd2qmd_mdast::render_blocks_fragment to render isolated blocks without frontmatter or surrounding whitespace. (refactor: render argument cells through the writer #109)

Changed

  • Breaking: Rename the default description list format to pandoc-definition-list (DescribeFormat::PandocDefinitionList), naming it after the syntax it uses. (refactor!: rename the Pandoc describe format to pandoc-definition-list #113)
    • Rust API: DescribeFormat::DefinitionList is removed; use DescribeFormat::PandocDefinitionList.
    • The former CLI and config value definition-list still selects the same format and prints a deprecation warning. The JSON schema marks it as deprecated. In a future release, definition-list will select the Quarto .definition-list format instead; use pandoc-definition-list to keep the current output.
  • Arguments cells in the list-table, list and grid-table formats now use the same Markdown conventions as the rest of the document, including _x_ emphasis and autolinks (<url>) when link text equals its URL. (refactor: render argument cells through the writer #109)
  • CLI help and README now explain q2/Quarto compatibility for Arguments and description-list formats, including q2 diagnostics and the recommended combination of list-table and quarto-definition-list. (docs: clarify q2 compatibility for output formats #116)

Fixed

  • Write frontmatter with a YAML emitter that quotes and escapes every value. Titles wrapped across lines in the Rd source are written on one line. Previously the continuation line of a wrapped title or pagetitle started in column 0, which YAML 1.2 forbids; q2 rejected such pages, while Quarto 1 accepted them. (fix: write frontmatter values as valid single-line YAML #115)
    • lifecycle and format values are now double-quoted like the other fields (for example lifecycle: "deprecated"). The YAML value is unchanged.
  • A list item whose first block is a nested list now writes the nested list on the marker line (- - a). q2 rejected the previous form, an empty marker line followed by the list. (feat!: add the quarto-definition-list describe format #114)
  • Bare brace groups in Rd text (for example { a, b } text) no longer drop their content. The group is now rendered in place without the braces, as R does. Braces inside \code{}, \verb{} and \preformatted{} are unchanged. (fix: keep the content of bare brace groups in Rd text #110)
  • Correct block rendering in Arguments cells. (refactor: render argument cells through the writer #109)
    • Cells that start with a code block or display equation now render validly in the list-table and list formats. Previously the list-table form failed to parse in q2.
    • Remove a spurious blank line before the closing fence of code blocks in grid-table cells.
  • Indent lines after a hard line break (\cr) inside a list item under the item, so they stay inside it instead of relying on lazy continuation. (refactor: render argument cells through the writer #109)
  • A \describe{} item whose description is only a list (for example \item{a}{\itemize{...}}) no longer turns the first list item into an indented code block in the Pandoc definition-list format. (fix: keep the first item of a list that starts a definition description #112)
  • Remove extra blank lines after lists, definition lists, and code blocks inside list items and definition descriptions. (fix: end every writer block with exactly one newline #111)
    • A tight list whose item holds a table or a definition list is no longer read as loose by CommonMark parsers.
  • Emphasis directly inside a word (for example before\emph{em}after) is no longer lost in common cases. It is now written with * where _ would not be recognized as an emphasis delimiter. Some nested combinations (such as emphasis inside a word at the edge of strong text) are still not recognized. (refactor: render argument cells through the writer #109)

Bump workspace and internal dependency versions to 0.7.0, with Cargo updating the workspace entries in the lockfile. Finalize the changelog for 2026-11-14, consolidate release notes, and add PR references.
@eitsupi
eitsupi merged commit 269f6e4 into main Nov 14, 2026
14 checks passed
@eitsupi
eitsupi deleted the release/0.7.0 branch November 14, 2026 08:51
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