inkmark 0.2.1 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57a396edb9b57902c126f56331f56132cae3c00a13208b8ae850d645a19be87d
-  data.tar.gz: ff500020da2be1f902c497d56961328b264a49eb0a32027e42364b348fe2db83
+  metadata.gz: 4a3feea6c75cbbc48daa868ce5aa140f1929df7b6b109ee83e6ed67c4b290351
+  data.tar.gz: ddddb3918c21fe25cf33f2b58370475c9e5f4a1a0b2963b32de904d9d096cf1f
 SHA512:
-  metadata.gz: 4b71c748877beac92c040e23e597c1290dc9b66843ff4f2afa1aa389acf8d4e94093c84c059ef77d1410f1bcb95c49fdcf3ce18b8373ac388e3ee3388e90379f
-  data.tar.gz: 1ded4e94b1baa611c54597c371557ec1b438a61a2d7187118db67600c40492b4dc28d88d2878f24ce0eb4ca08774ad50e2a87c62ecda8222c726ed5f203ecbd7
+  metadata.gz: 0a02d6c1b1f9067787cf880fbf044b59bc05220bc075d99332af7e0cac416f2bdcf2545b935d7d309db45411d67f01ab4f0614ed52f0ddc1f28bb261ddff892c
+  data.tar.gz: 242ecf84608b2de0fdd37e883506d3fbd0ec7cb1dc5184bbb707e1648a99e0ca4d3834ee48d74b21d69d90cf5c3922fb1c36d48754b521c858c20e00c3af9e17

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+## [0.3.1] - 2026-10-24
+
+- Re-release of 0.3.0, which was yanked.
+- Breaking: Markdown output (`to_markdown`, `chunks_by_heading`, `chunks_by_size`, `truncate_markdown`) uses pulldown-cmark-to-cmark 23; escaping and formatting differ from 0.2.
+- Fix raw HTML leaking into Markdown output with `raw_html: false` when a line held more than one tag.
+- Fix `chunks_by_size` and `truncate_markdown` (`at: :block`) joining blocks without a blank line, which merged adjacent paragraphs.
+- Fix Markdown output crashing on an image nested in another image's alt text with `images: { lazy: true }`, `allowed_hosts`, or `allowed_schemes`.
+- `chunks_by_heading` starts sections only at top-level headings; a heading inside a block quote or list item no longer splits it.
+- Raise `Inkmark::Error` on Markdown serialization failures instead of crashing the process.
+
+## [0.3.0] - 2026-10-24 [YANKED]
+
+- Yanked: a RubyGems issue interrupted publishing, so only one platform gem was released. Its changes shipped in 0.3.1.
+
+## [0.2.2] - 2026-10-24
+
+- Updated dependencies, including pulldown-cmark 0.13.5 (upstream security fixes) and magnus 0.9.3.
+
 ## [0.2.1] - 2026-09-25
 
 - Updated dependencies, including magnus 0.9.

data/Cargo.lock

@@ -109,9 +109,9 @@ dependencies = [
 
 [[package]]
 name = "crc32fast"
-version = "1.5.2"
+version = "1.5.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "01a7799fd6b852db0e61728dde9a204c423b44d689dbd432522543614b490e78"
+checksum = "0ba106e844045ddc02c20768ac4b0b7cb45f2cc2ecbd833ac9f5dacb183c2055"
 dependencies = [
  "cfg-if",
 ]
@@ -130,29 +130,29 @@ checksum = "c6232dd377dcc64799954cbd3a9bb882e9cdc1308ccd87b1c098f1fb2eaf82a8"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 3.0.6",
+ "syn 3.0.9",
 ]
 
 [[package]]
 name = "either"
-version = "1.18.0"
+version = "1.19.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "252afb9ae5eaa683babdc6a068b3f5726eb19e05070c731f9b2a23a7c3e8ed34"
+checksum = "0e9c71c2167ca323c882b99918929403426e2373ea17242ff5653e0d5e1058be"
 
 [[package]]
 name = "emojis"
-version = "0.9.0"
+version = "0.9.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0b1514ced566c94991ed9563258ecf61e311fd773bf0a3f20606830386bf66e3"
+checksum = "589871e639330783bc20ad89d32ac1b049e02c273d96c907ca27478c8bc674a2"
 dependencies = [
  "phf",
 ]
 
 [[package]]
 name = "equivalent"
-version = "1.0.2"
+version = "1.0.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
+checksum = "00d174d5400e5e8fd687ad1049e2f578285fa914201b1af7e8b112a4546bd826"
 
 [[package]]
 name = "fancy-regex"
@@ -229,9 +229,9 @@ dependencies = [
 
 [[package]]
 name = "icu_collections"
-version = "2.3.0"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fa68d21081c4a05d5a901a1c62add574c77048b6a1c67be3b50ce0b60d4ca513"
+checksum = "fe090a42a0d3140fed8c63263ed1fecc02422cb2f4bfe55cd8de2de1b8e105dd"
 dependencies = [
  "displaydoc",
  "potential_utf",
@@ -243,9 +243,9 @@ dependencies = [
 
 [[package]]
 name = "icu_locale_core"
-version = "2.3.0"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d56e28588da92eee5c3201a6eff33fabdd49b62269c8938d4ff050ce4d900deb"
+checksum = "25d29b57c17c6528d0dc4c2141cfa2d08200465acb537a3909c8b9b8a4a984c0"
 dependencies = [
  "displaydoc",
  "litemap",
@@ -256,9 +256,9 @@ dependencies = [
 
 [[package]]
 name = "icu_normalizer"
-version = "2.3.0"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "12f9cf5f235641ed274641dd81c3f28d870e276763d0797aeeab72317b1c646f"
+checksum = "404a3b8c486f205c87fe7f23ab6894d84a4ad76d6e4671ae1981ba7def87c599"
 dependencies = [
  "icu_collections",
  "icu_normalizer_data",
@@ -270,15 +270,15 @@ dependencies = [
 
 [[package]]
 name = "icu_normalizer_data"
-version = "2.3.0"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1563da1ed3e0b3bf3d74c9b85917ac9c56464d2f57242270c09c9e752f8021a0"
+checksum = "20f0088bfb7441f7a37fa0c9e20cb1e9cba1cac6b9ce8cd2a6dc44294f8e8cbc"
 
 [[package]]
 name = "icu_properties"
-version = "2.3.0"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7e7ca276ad3145661a65914e6daf131ca5120cd3dcee8f8f3214b8875184a148"
+checksum = "2ea83d991c56158f7cf898bf86436c1dfe7c07ee82fe88951f2695c9f37a379f"
 dependencies = [
  "displaydoc",
  "icu_collections",
@@ -291,15 +291,15 @@ dependencies = [
 
 [[package]]
 name = "icu_properties_data"
-version = "2.3.0"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e590f038c1464a96894fd6d10127e90a8be4509f56ff7ecef851b15cee0b7caa"
+checksum = "b98f29af82d02b163fe50161388350e743bb3107cc8e8c2f7314cb505faddfcf"
 
 [[package]]
 name = "icu_provider"
-version = "2.3.1"
+version = "2.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d27bbb9d3abbefac45d55f647c9de1d44aafcd1186eb91879afef17c396c3e73"
+checksum = "413099315636c588ee8f011190b329b971a09a8fae9d157e01dcae8379468514"
 dependencies = [
  "displaydoc",
  "icu_locale_core",
@@ -333,7 +333,7 @@ dependencies = [
 
 [[package]]
 name = "inkmark"
-version = "0.2.1"
+version = "0.3.1"
 dependencies = [
  "deunicode",
  "emojis",
@@ -363,15 +363,15 @@ dependencies = [
 
 [[package]]
 name = "lazy_static"
-version = "1.5.0"
+version = "1.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
+checksum = "20870f649af7073d53e38067b2a84312175d56ea15217e1b15bc83506ec50afb"
 
 [[package]]
 name = "libc"
-version = "0.2.189"
+version = "0.2.191"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"
+checksum = "65cd87c9a6d60536580b316ad985726104730a5151c99845f2490428ef91240a"
 
 [[package]]
 name = "libloading"
@@ -406,9 +406,9 @@ checksum = "f9f8bd3e56ce4dfc153cf470fffbfa98c7620958b312ca5c3a4b8d5181fd13c6"
 
 [[package]]
 name = "magnus"
-version = "0.9.0"
+version = "0.9.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "379d50b6eea4ca84074ccd3e551eb9b07f7865194d5b3198325317e9ef78e5e9"
+checksum = "40ef424404d166cbb71c8b8d19c9c589c748c4547c1afa1928c5504299f6c713"
 dependencies = [
  "magnus-macros",
  "rb-sys",
@@ -418,9 +418,9 @@ dependencies = [
 
 [[package]]
 name = "magnus-macros"
-version = "0.9.0"
+version = "0.9.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4ca70566af98184bb92d4d9853daaf533c1a3418b9570d0547ea44970035f3fe"
+checksum = "9dafde2eeb66f090e0f326112323eb8324b12cb32b5d1210e541d3df6b0ce77e"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -509,9 +509,9 @@ dependencies = [
 
 [[package]]
 name = "pulldown-cmark"
-version = "0.13.4"
+version = "0.13.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e9f068eba8e7071c5f9511831b44f32c740d5adf574e990f946ddb53db2f314e"
+checksum = "278e9268c93b9e498a2da46c34d90ba93a3255eb99009646398f34bc73ab36eb"
 dependencies = [
  "bitflags",
  "memchr",
@@ -527,11 +527,12 @@ checksum = "007d8adb5ddab6f8e3f491ac63566a7d5002cc7ed73901f72057943fa71ae1ae"
 
 [[package]]
 name = "pulldown-cmark-to-cmark"
-version = "22.0.1"
+version = "23.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ab1ad36992cead65f02aa399a373a42730922f1525d988172634fdefdecb8a60"
+checksum = "e9e14cd4ec725b2227ba76d4772169af814438bcf48f6d9b806d1308f40a7413"
 dependencies = [
  "pulldown-cmark",
+ "unicase",
 ]
 
 [[package]]
@@ -670,7 +671,7 @@ checksum = "e7a5d71263a5a7d47b41f6b3f06ba276f10cc18b0931f1799f710578e2309348"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 3.0.6",
+ "syn 3.0.9",
 ]
 
 [[package]]
@@ -699,9 +700,9 @@ checksum = "33f4fe9184a62d842c9ef383018f3306d8ba224fd9d836f56d7288308847c256"
 
 [[package]]
 name = "smallvec"
-version = "1.16.2"
+version = "1.16.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f9395f0f0eee849a9b707b2f06bb92a6a422090e2123bb2ef8e87a0e61892a8e"
+checksum = "d0d5d4b1981b8bbbb7aed204cae5726d683d5d6ac7e74ec54122ea28f315e7c8"
 
 [[package]]
 name = "stable_deref_trait"
@@ -722,9 +723,9 @@ dependencies = [
 
 [[package]]
 name = "syn"
-version = "3.0.6"
+version = "3.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8593e8e72159ed2257d083c7a454a85cbf854f37a0966d8d483aff8c8a3ebcee"
+checksum = "d78c8dee4c7bf0e14673097256fed6142ce9d3b85a408189d07482442145823b"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -739,7 +740,7 @@ checksum = "901704edd0dfe137f1987838ee4f259e4e063c31371bdb423f7ae38ec6f77f02"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 3.0.6",
+ "syn 3.0.9",
 ]
 
 [[package]]
@@ -777,14 +778,14 @@ checksum = "fe5197923287db20a58125f0bc85c062f7f2c892de97b18c356f9efb14b28524"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 3.0.6",
+ "syn 3.0.9",
 ]
 
 [[package]]
 name = "tinystr"
-version = "0.8.4"
+version = "0.8.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1e27c91459209c2986af3dcf603a5a74a4368754ce37414f59acc971167f643"
+checksum = "abc840c238154d58f9e86b2792261edfde565a17696e1cda1a449de27979801a"
 dependencies = [
  "displaydoc",
  "zerovec",
@@ -792,15 +793,15 @@ dependencies = [
 
 [[package]]
 name = "unicase"
-version = "2.9.0"
+version = "2.10.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dbc4bc3a9f746d862c45cb89d705aa10f187bb96c76001afab07a0d35ce60142"
+checksum = "357cc3acc6a036009fd6c973ed009037c732d60d0b4f6c673e9041497482a28f"
 
 [[package]]
 name = "unicode-ident"
-version = "1.0.26"
+version = "1.0.27"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d245f478577f809a851594d02313b640fb437e0bb33866753cff937863096954"
+checksum = "a2c754d6c33795a1c324727428e5a7dedb5b06195f9890bdbcba760d3e246563"
 
 [[package]]
 name = "unicode-segmentation"
@@ -877,9 +878,9 @@ checksum = "3ad82d2a33cdc9674dc7465672f271e096168fcdbe0f799d9e6db8c5892679dc"
 
 [[package]]
 name = "yoke"
-version = "0.8.3"
+version = "0.8.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "709fe23a0424b6a435d82152b1bd3fdfb0833487d5fa90d05d42762a9891fef5"
+checksum = "417ef3fcf6c300b7dbd25c85531a746931c02ad536f3cf4786ed1e88223340b3"
 dependencies = [
  "stable_deref_trait",
  "yoke-derive",
@@ -888,13 +889,13 @@ dependencies = [
 
 [[package]]
 name = "yoke-derive"
-version = "0.8.3"
+version = "0.8.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "33811428bee40dbceb6d545e95754741d17a6aef9a4849f0fd62e2ba4f412a78"
+checksum = "ec8ebde2db3681e8c9980cc27822030e68752690ddfa9473e739aeb4dbde6d71"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 3.0.6",
+ "syn 3.0.9",
  "synstructure",
 ]
 
@@ -915,7 +916,7 @@ checksum = "f75b4683f6c7f45248d4d64056a24298c6281e0993356d7d1b4a1a962ef10d4a"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 3.0.6",
+ "syn 3.0.9",
  "synstructure",
 ]
 
@@ -932,9 +933,9 @@ dependencies = [
 
 [[package]]
 name = "zerovec"
-version = "0.11.8"
+version = "0.11.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bb0464e17806c1d976d5cba29399c7f08e516e279e2ba493f63123b5fca67dd8"
+checksum = "f58a2799cfe9a1670c7ea8edbd52ef8edb93cb37a7f83bf31ba9e35d9dae6a40"
 dependencies = [
  "yoke",
  "zerofrom",
@@ -943,13 +944,13 @@ dependencies = [
 
 [[package]]
 name = "zerovec-derive"
-version = "0.11.6"
+version = "0.11.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "34df6fc39dbd26ddc9c10e6a2984476e13acce22e64e4487636ef494369225da"
+checksum = "c3743ddbf47738d929cd1ae2e199d40d0162979dfe31aef8ae646d2bf00bf97a"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 3.0.6",
+ "syn 3.0.9",
 ]
 
 [[package]]

data/README.md

@@ -206,6 +206,9 @@ Inkmark.to_html("<script>alert(1)</script>")
 # => "<p>&lt;script&gt;alert(1)&lt;/script&gt;</p>\n"
 ```
 
+Markdown output escapes it too; see
+[Raw HTML in the source](#raw-html-in-the-source).
+
 Enable pass-through with `raw_html: true`; _only do this for trusted
 input_:
 
@@ -403,6 +406,12 @@ nested `###` subsections, which also appear as their own entries. Content
 before the first heading (if any) becomes a preamble entry with
 `heading: nil` and `level: 0`.
 
+Only **top-level** headings start a section. A heading inside a block
+quote or list item (such as a `## Tip` in a `> [!NOTE]` callout) stays in
+the content of the section around it, so the quote or list is never split
+across sections. It still counts toward slug deduplication, so every
+section's `:id` matches the anchor `headings: { ids: true }` generates.
+
 `:breadcrumb` carries the ancestor heading texts from root to immediate
 parent. Root-level sections and the preamble have an empty array. Skipped
 levels are omitted, so an `###` directly under an `#` has `breadcrumb:
@@ -740,6 +749,17 @@ Inkmark.to_markdown(source, options: {
 })
 ```
 
+### Raw HTML in the source
+
+With `raw_html: false` (the default), raw HTML from the source comes out of
+`to_markdown`, `chunks_by_heading`, `chunks_by_size`, and `truncate_markdown`
+escaped, so the Markdown stays inert even if a later stage renders it with raw
+HTML allowed. HTML produced by the HTML-emitting filters above is the
+exception: it is embedded as described.
+
+If the filtered document cannot be written back as Markdown, these methods
+raise `Inkmark::Error`.
+
 ## Event handlers
 
 Register handlers with `#on` to inspect or transform document elements as they

data/ext/inkmark/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "inkmark"
-version = "0.2.1"
+version = "0.3.1"
 edition = "2021"
 authors = ["Yaroslav Markin <yaroslav@markin.net>"]
 license = "MIT"
@@ -22,7 +22,7 @@ syntect = { version = "5.2", default-features = false, features = ["parsing", "h
 linkify = "0.11"
 globset = "0.4"
 url = "2"
-pulldown-cmark-to-cmark = "22"
+pulldown-cmark-to-cmark = "23"
 
 [build-dependencies]
 rb-sys-env = "0.2.2"

data/ext/inkmark/src/chunks_by_heading.rs

@@ -14,6 +14,12 @@
 //! emoji/autolink rewrites happen *inside* a heading's text events,
 //! but the bracketing tags stay in place—so post-filter heading-
 //! position scanning is coherent.
+//!
+//! Only top-level headings start a section. A heading inside a block
+//! quote, list item, or other container stays in the content of the
+//! section around it, so a container is never split across sections.
+//! Nested headings still consume slugs, keeping section ids aligned
+//! with the ids `heading_ids` / `toc` emit.
 
 use magnus::{Error, RArray, RHash, Ruby};
 use pulldown_cmark::{Event, HeadingLevel, Parser, Tag, TagEnd};
@@ -21,6 +27,7 @@ use unicode_segmentation::UnicodeSegmentation;
 
 use crate::document::{apply_filters, content_events};
 use crate::heading::{self, SlugDeduplicator};
+use crate::markdown;
 use crate::options::build_options;
 use crate::toc;
 use crate::truncate::{self, TruncateParams};
@@ -57,8 +64,13 @@ pub fn native_chunks_by_heading(
     let content_opts = ContentOptions {
         with_counts: flags.statistics,
         truncate_params: truncate_params.as_ref(),
+        md_opts: markdown::serializer_options(cm_opts, &flags),
     };
-    let preamble_end = boundaries.first().map(|b| b.start).unwrap_or(events.len());
+    let preamble_end = boundaries
+        .iter()
+        .find(|b| b.top_level)
+        .map(|b| b.start)
+        .unwrap_or(events.len());
     if preamble_end > 0 {
         let preamble_events = &events[0..preamble_end];
         if !is_empty_content(preamble_events) {
@@ -78,23 +90,29 @@ pub fn native_chunks_by_heading(
     let mut dedup = SlugDeduplicator::new();
     let mut ancestors: Vec<(u8, String)> = Vec::new();
     for (i, boundary) in boundaries.iter().enumerate() {
+        let heading_text = collect_inline_text(&events[(boundary.start + 1)..boundary.end]);
+        let id = heading_id(&mut dedup, &heading_text);
+        if !boundary.top_level {
+            // Stays in the surrounding section's content; only its slug
+            // counts, so later ids match `heading_ids`.
+            continue;
+        }
         let section_end = find_section_end(&boundaries, i, events.len());
         let level = toc::level_to_u8(boundary.level);
         while ancestors.last().is_some_and(|(l, _)| *l >= level) {
             ancestors.pop();
         }
         let breadcrumb: Vec<&str> = ancestors.iter().map(|(_, t)| t.as_str()).collect();
-        let heading_text = collect_inline_text(&events[(boundary.start + 1)..boundary.end]);
         // Content = events after End(Heading) up to the next section or
-        // end of document. Re-serialized through cmark_write.
+        // end of document. Re-serialized through `markdown::render`.
         let content_events = &events[(boundary.end + 1)..section_end];
         let hash = build_section_hash(
             ruby,
             boundary.level,
             &heading_text,
+            &id,
             &breadcrumb,
             content_events,
-            &mut dedup,
             &content_opts,
         )?;
         result.push(hash)?;
@@ -110,6 +128,9 @@ struct HeadingBoundary {
     start: usize,
     end: usize,
     level: HeadingLevel,
+    /// Not inside a block quote, list item, or other container. Only
+    /// top-level headings start sections.
+    top_level: bool,
 }
 
 /// How each entry's `content` is rendered: optionally truncated, and
@@ -117,14 +138,20 @@ struct HeadingBoundary {
 struct ContentOptions<'a> {
     with_counts: bool,
     truncate_params: Option<&'a TruncateParams>,
+    /// Serializer options, from `markdown::serializer_options`.
+    md_opts: pulldown_cmark::Options,
 }
 
 fn find_heading_boundaries(events: &[Event<'_>]) -> Vec<HeadingBoundary> {
     let mut boundaries = Vec::new();
+    // Containers open around the cursor. Headings are leaf blocks, so
+    // none open at a Start(Heading) means it is not inside anything.
+    let mut open_containers = 0usize;
     let mut i = 0;
     while i < events.len() {
         if let Event::Start(Tag::Heading { level, .. }) = &events[i] {
             let lvl = *level;
+            let top_level = open_containers == 0;
             // CommonMark disallows headings inside headings, but carry a
             // depth counter so we stay correct if pulldown-cmark ever
             // permits them.
@@ -147,23 +174,29 @@ fn find_heading_boundaries(events: &[Event<'_>]) -> Vec<HeadingBoundary> {
                 start: i,
                 end: j,
                 level: lvl,
+                top_level,
             });
             i = j + 1;
         } else {
+            match &events[i] {
+                Event::Start(_) => open_containers += 1,
+                Event::End(_) => open_containers = open_containers.saturating_sub(1),
+                _ => {}
+            }
             i += 1;
         }
     }
     boundaries
 }
 
-/// Section i ends at the first subsequent heading with level <=
-/// current. Headings with a strictly greater level are subsections:
+/// Section i ends at the first subsequent top-level heading with level
+/// <= current. Headings with a strictly greater level are subsections:
 /// they belong to the current section's content too.
 fn find_section_end(boundaries: &[HeadingBoundary], i: usize, events_len: usize) -> usize {
     let current = toc::level_to_u8(boundaries[i].level);
     boundaries[(i + 1)..]
         .iter()
-        .find(|b| toc::level_to_u8(b.level) <= current)
+        .find(|b| b.top_level && toc::level_to_u8(b.level) <= current)
         .map(|b| b.start)
         .unwrap_or(events_len)
 }
@@ -181,10 +214,7 @@ fn build_preamble_hash(
     // with proper sections so callers can treat every entry alike.
     hash.aset(ruby.to_symbol("breadcrumb"), ruby.ary_new_capa(0))?;
 
-    let content = match content_opts.truncate_params {
-        Some(params) => truncate::truncate_events(events, params),
-        None => render_markdown(events),
-    };
+    let content = render_content(ruby, events, content_opts)?;
     if content_opts.with_counts {
         let (chars, words) = count_post_truncate(events, content_opts.truncate_params, &content);
         hash.aset(ruby.to_symbol("character_count"), chars)?;
@@ -198,21 +228,11 @@ fn build_section_hash(
     ruby: &Ruby,
     level: HeadingLevel,
     heading_text: &str,
+    id: &str,
     breadcrumb: &[&str],
     content_events: &[Event<'_>],
-    dedup: &mut SlugDeduplicator,
     content_opts: &ContentOptions<'_>,
 ) -> Result<RHash, Error> {
-    // Slug is the deduplicated slugify of the (filter-applied) heading
-    // text, matching the ids `heading_ids` / `toc` would emit for the
-    // same document.
-    let base = heading::slugify(heading_text);
-    let id = if base.is_empty() {
-        String::new()
-    } else {
-        dedup.deduplicate(base)
-    };
-
     let hash = ruby.hash_new();
     hash.aset(ruby.to_symbol("heading"), heading_text)?;
     hash.aset(ruby.to_symbol("level"), toc::level_to_u8(level))?;
@@ -227,10 +247,7 @@ fn build_section_hash(
     }
     hash.aset(ruby.to_symbol("breadcrumb"), breadcrumb_arr)?;
 
-    let content = match content_opts.truncate_params {
-        Some(params) => truncate::truncate_events(content_events, params),
-        None => render_markdown(content_events),
-    };
+    let content = render_content(ruby, content_events, content_opts)?;
     if content_opts.with_counts {
         let (chars, words) =
             count_post_truncate(content_events, content_opts.truncate_params, &content);
@@ -289,11 +306,24 @@ fn count_text(events: &[Event<'_>]) -> (usize, usize) {
     (chars, words)
 }
 
-fn render_markdown(events: &[Event<'_>]) -> String {
-    let mut buf = String::new();
-    pulldown_cmark_to_cmark::cmark(events.iter().cloned(), &mut buf)
-        .expect("markdown serialization failed");
-    buf
+/// Deduplicated slug of the (filter-applied) heading text, matching the
+/// ids `heading_ids` / `toc` would emit for the same document. Empty when
+/// the text has nothing to slugify.
+fn heading_id(dedup: &mut SlugDeduplicator, heading_text: &str) -> String {
+    dedup.deduplicate(heading::slugify(heading_text))
+}
+
+/// Serialize a section's events to Markdown, truncated when requested.
+fn render_content(
+    ruby: &Ruby,
+    events: &[Event<'_>],
+    content_opts: &ContentOptions<'_>,
+) -> Result<String, Error> {
+    match content_opts.truncate_params {
+        Some(params) => truncate::truncate_events(events, params, content_opts.md_opts),
+        None => markdown::render(events, content_opts.md_opts),
+    }
+    .map_err(|e| markdown::to_ruby_error(ruby, e))
 }
 
 fn collect_inline_text(events: &[Event<'_>]) -> String {
@@ -324,3 +354,33 @@ fn is_empty_content(events: &[Event<'_>]) -> bool {
         )
     })
 }
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use pulldown_cmark::Options;
+
+    fn events(source: &str) -> Vec<Event<'_>> {
+        Parser::new_ext(source, Options::empty()).collect()
+    }
+
+    #[test]
+    fn headings_inside_containers_are_not_top_level() {
+        let ev = events("# Top\n\n> ## Quoted\n\n- # Listed\n\n## Sub\n");
+        let top_level: Vec<bool> = find_heading_boundaries(&ev)
+            .iter()
+            .map(|b| b.top_level)
+            .collect();
+        assert_eq!(top_level, vec![true, false, false, true]);
+    }
+
+    #[test]
+    fn section_spanning_a_nested_heading_stays_balanced() {
+        let ev = events("# Top\n\n> ## Inner\n> text\n\nafter\n");
+        let boundaries = find_heading_boundaries(&ev);
+        let end = find_section_end(&boundaries, 0, ev.len());
+        let content = &ev[(boundaries[0].end + 1)..end];
+        let md = markdown::render(content, Options::empty()).expect("balanced slice");
+        assert!(md.contains("Inner") && md.contains("after"), "{md:?}");
+    }
+}