Parameter details after the first example are collapsed by mistake

### Description

For some parameters, the details and examples are interspersed together, and details after the first example are collapsed into the example, which is confusing.

Both the official https://typst.app/docs and the community [typst-jp/docs](https://typst-jp.github.io/docs/reference/layout/place/#parameters-dx) are affected.

### Take [`place.dx`](https://typst.app/docs/reference/layout/place/#parameters-dx) for an instance

Look at the source markup of `place.dx`: First a paragraph, then an example, and finally another paragraph.
https://github.com/typst/typst/blob/88b6fc0a6ccd517b38c6534f16c88763e5545617/crates/typst-library/src/layout/place.rs#L138-L151

On [the docs website](https://typst.app/docs/reference/layout/place/#parameters-dx), the second paragraph is collapsed into the example, even though it does not describe the example.

<img width="300" alt="Image" src="https://github.com/user-attachments/assets/eac9c82b-de43-4590-948e-c50b45a27461" />

<img width="400" alt="Image" src="https://github.com/user-attachments/assets/eb196303-3b67-4a24-94ec-5998449423d4" />

On the typst-jp website:

<img width="400" alt="图片" src="https://github.com/user-attachments/assets/5ad7b990-cffb-496f-907e-87b11cf22299" />


### Suggestions

- **Option A:** Allow details and examples to be interspersed together.
- ~~**Option B:** Find all docs doing so and alter their wordings.~~

[Discord](https://discord.com/channels/1054443721975922748/1399326777540608041/1417444650322624512)

> laurmaedje
> yeah I know about this. I intended to do something about before the release.

### Debug

<details>
<summary>Current implementations</summary>

https://github.com/typst/typst/blob/88b6fc0a6ccd517b38c6534f16c88763e5545617/docs/src/lib.rs#L482-L494
https://github.com/typst/typst/blob/88b6fc0a6ccd517b38c6534f16c88763e5545617/docs/src/model.rs#L106-L111

</details>

```bash
$ cd crates/typst-library
$ rg '\s+/// ```\r?\n\s+///' --multiline --files-with-matches
src/text/raw.rs
src/math/matrix.rs
src/text/mod.rs
src/model/figure.rs
src/layout/transform.rs
src/foundations/str.rs
src/layout/place.rs
src/layout/grid/mod.rs
```

	/// The horizontal displacement of the placed content.
	///
	/// ```example
	/// #set page(height: 100pt)
	/// #for i in range(16) {
	/// let amount = i * 4pt
	/// place(center, dx: amount - 32pt, dy: amount)[A]
	/// }
	/// ```
	///
	/// This does not affect the layout of in-flow content.
	/// In other words, the placed content is treated as if it
	/// were wrapped in a [`move`] element.
	pub dx: Rel<Length>,

	/// Split up documentation into details and an example.
	fn split_details_and_example(docs: &str) -> (&str, Option<&str>) {
	let mut details = docs;
	let mut example = None;
	if let Some(mut i) = docs.find("```") {
	while docs[..i].ends_with('`') {
	i -= 1;
	}
	details = &docs[..i];
	example = Some(&docs[i..]);
	}
	(details, example)
	}

	/// Details about a function parameter.
	#[derive(Debug, Serialize)]
	pub struct ParamModel {
	pub name: &'static str,
	pub details: Html,
	pub example: Option<Html>,

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Parameter details after the first example are collapsed by mistake #6922

Description

Take `place.dx` for an instance

Suggestions

Debug

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Uh oh!

Parameter details after the first example are collapsed by mistake #6922

Description

Description

Take place.dx for an instance

Suggestions

Debug

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

Take `place.dx` for an instance