chore(deps): update module github.com/nao1215/markdown to v1 #30

Open
renovate-bot wants to merge 1 commit from renovate/github.com-nao1215-markdown-1.x into main
Collaborator

This PR contains the following updates:

Package Type Update Change
github.com/nao1215/markdown require major v0.13.0 → v1.1.0

Release Notes

nao1215/markdown (github.com/nao1215/markdown)

v1.1.0

Compare Source

Changed
  • markdown now requires Go 1.26 or later (was 1.23). golang.org/x/sys v0.48.0, which fatih/color and tablewriter pull in, declares go 1.26.0, and Go 1.26 and 1.27 are the two releases the Go team still supports. The exported API and the generated bytes are unchanged.

v1.0.0

Compare Source

From this release the exported API and the generated bytes are stable. Within
v1.x nothing exported is removed, renamed or re-signatured, and every builder
keeps producing byte-for-byte identical output; the only exception is output
that is objectively wrong, which is fixed in a patch release with the reasoning
recorded here. doc/v1-api-audit.md is the inventory of
the exported symbols they cover.

Added: mermaid diagram types
Added: API
  • EscapeTableCell, and TableSet.EscapeCells to apply it to a whole table #​113
  • WithBlockSpacing, and with it the Option parameter on NewMarkdown #​111
  • Markdown.BlankLine, the clearer name for LF #​111
  • Error on the entity relationship, flowchart and pie chart builders, which every other builder already had #​176
  • Flowchart subgraphs, direction, and the styling the other builders have #​181
Fixed: output that did not render

Each of these replaced output that mermaid refused to draw or that GitHub read
as something other than what the call described. Labels that already rendered
are untouched, which the golden files enforce.

  • A quotation mark lost a flowchart, a pie chart, an entity relationship diagram #​157 #​159 #​161
  • A colon cut a gantt task name short, ended a class statement, ended a state note #​162 #​163 #​168
  • Each user journey field lost a different set of characters, including a comma that split one actor into two #​164
  • Shape delimiters lost a mindmap; a kanban card label was rejected rather than encoded #​166 #​167
  • An xy chart label of non-ASCII text went out unquoted and lost the chart #​165
  • A sequence diagram read a hyphen in a participant name as an arrow, and a "#" in a message as a comment #​169
  • A quadrant chart could not read most punctuation in any of its labels #​170
  • Front matter titles are quoted, and control characters in them escaped, so YAML cannot swallow a title #​117
  • Table alignment, nil writers, the table of contents indent, and line endings on Windows #​110 #​112
  • A class annotation is emitted inside the class body, where GitHub accepts it #​115
  • The index links to markdown files relative to itself, with URL separators #​142

Extending the probe set past the first measurement found more, fixed the same
way #​187:

  • A raw line break in a label lost or silently corrupted every diagram type
    that accepts one; it is written as <br/>, or as #&#8203;10; where that is the
    form the drawing decodes
  • A ~, @ or ^ lost a quadrant chart; a + or @ lost a sequence
    diagram from its participant name; a ^ in kanban metadata lost the board
  • A < in a title was eaten by the renderer's sanitizer along with the rest;
    it is written as #&#8203;60; in the title statements that decode it
  • A timeline colon was drawn as &:, a # cut a period short, and %% lost
    a whole line — the timeline package was the one type the probe had missed
  • A backslash in a quoted class, xy chart, packet, block, git graph or
    requirement string was drawn as &\, the half decoded HTML form; it is
    written as #&#8203;92;, which draws the character
  • An &, < or > in a git graph or xy chart string was drawn as the
    literal text &amp;, &lt; or &gt;; a < in a block label or a
    requirement name was read as an opening tag and ate the rest; a " in a
    packet field or an xy chart title was drawn as the literal &quot; — each
    is written as the entity form its drawing decodes
  • The renderer check now asserts, character by character, that everything an
    edge-case document declares actually reaches the rendered SVG text; parse
    and render alone had let each of the above ship

mermaid/arch is the one place a label still cannot carry punctuation:
mermaid's architecture-beta grammar accepts only [A-Za-z0-9_ ] and refuses
its own escape form, so there is nothing to encode to. The package documentation
says so #​171. A sankey node
name refuses <, tab and zero-width characters along with non-ASCII text, and
a front matter title draws every escape of < as literal text, so those two
limits are documented the same way.

A mermaid title that is not valid UTF-8 is reinterpreted rather than mangled,
which is documented rather than changed #​155.

Documentation
  • A godoc example for every exported symbol, 705 of them, each output-verified #​174 #​175
  • doc/v1-api-audit.md: every exported symbol and its verdict #​176
  • Every README example reproduces the file it links to, and a test keeps it that way #​173
Tests and CI
  • Golden files pin the output of every builder #​135
  • The generated markdown is read back with a GFM parser #​143
  • Fuzzing over the quoting and escaping boundaries, with a parser as the oracle #​145
  • Every committed mermaid diagram is drawn by the real renderer in CI, including one document per diagram type whose every label holds the punctuation that type can carry #​147 #​172
  • Pull requests are rejected for incompatible API changes #​138 #​152
  • The error handling every builder shares is pinned in one place #​141
  • Tests live in one file per package rather than one per viewpoint #​154
Upgrading from v0.13.0

Your code needs no change. The exported API gained 112 symbols and lost none;
the only signature that changed is NewMarkdown, which gained a variadic
options parameter, so every existing call site still compiles. Only code that
assigned the function itself to a func(io.Writer) *Markdown variable is
affected.

Your regenerated documents will differ, and not only where the old output
was broken. Running the v0.13.0 sample generators unchanged against this release
gives these differences:

change what it affects
every document now ends with a line ending every document
a mermaid front matter title is quoted: title: Checkout becomes title: "Checkout" diagrams whose title goes in front matter, which is not the ones writing a title statement
a block diagram title moves from a title statement into the front matter block diagrams with a title
a class annotation moves inside the class body class diagrams using <<Interface>>
the label escaping listed above only labels holding the punctuation concerned, which did not render before

The first is the widest: nothing about it was broken, and it changes every file.
It is deliberate. markdownlint's MD047 requires the trailing line ending, and
without it a second document appended to the same writer splices its first line
onto the last line of the first. The rest each replaced output that mermaid
would not draw or that YAML read as something other than the title given.

Expect a one-line diff in every generated file, and review the diagram titles
once. After that, v1.x holds the bytes still.


Configuration

📅 Schedule: (UTC)

  • Branch creation
    • At any time (no schedule defined)
  • Automerge
    • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.


  • If you want to rebase/retry this PR, check this box

This PR has been generated by Mend Renovate CLI.

This PR contains the following updates: | Package | Type | Update | Change | |---|---|---|---| | [github.com/nao1215/markdown](https://github.com/nao1215/markdown) | require | major | `v0.13.0` → `v1.1.0` | --- ### Release Notes <details> <summary>nao1215/markdown (github.com/nao1215/markdown)</summary> ### [`v1.1.0`](https://github.com/nao1215/markdown/blob/HEAD/CHANGELOG.md#v110-2026-09-21) [Compare Source](https://github.com/nao1215/markdown/compare/v1.0.0...v1.1.0) ##### Changed - markdown now requires Go 1.26 or later (was 1.23). golang.org/x/sys v0.48.0, which fatih/color and tablewriter pull in, declares `go 1.26.0`, and Go 1.26 and 1.27 are the two releases the Go team still supports. The exported API and the generated bytes are unchanged. ### [`v1.0.0`](https://github.com/nao1215/markdown/blob/HEAD/CHANGELOG.md#v100-2026-08-13) [Compare Source](https://github.com/nao1215/markdown/compare/v0.13.0...v1.0.0) **From this release the exported API and the generated bytes are stable.** Within v1.x nothing exported is removed, renamed or re-signatured, and every builder keeps producing byte-for-byte identical output; the only exception is output that is objectively wrong, which is fixed in a patch release with the reasoning recorded here. [doc/v1-api-audit.md](doc/v1-api-audit.md) is the inventory of the exported symbols they cover. ##### Added: mermaid diagram types - Timeline [#&#8203;149](https://github.com/nao1215/markdown/pull/149) - Sankey [#&#8203;150](https://github.com/nao1215/markdown/pull/150) - Radar [#&#8203;151](https://github.com/nao1215/markdown/pull/151) - Treemap [#&#8203;153](https://github.com/nao1215/markdown/pull/153) - C4 context [#&#8203;156](https://github.com/nao1215/markdown/pull/156) - Venn [#&#8203;182](https://github.com/nao1215/markdown/pull/182) - Wardley map [#&#8203;183](https://github.com/nao1215/markdown/pull/183) ##### Added: API - `EscapeTableCell`, and `TableSet.EscapeCells` to apply it to a whole table [#&#8203;113](https://github.com/nao1215/markdown/pull/113) - `WithBlockSpacing`, and with it the `Option` parameter on `NewMarkdown` [#&#8203;111](https://github.com/nao1215/markdown/pull/111) - `Markdown.BlankLine`, the clearer name for `LF` [#&#8203;111](https://github.com/nao1215/markdown/pull/111) - `Error` on the entity relationship, flowchart and pie chart builders, which every other builder already had [#&#8203;176](https://github.com/nao1215/markdown/pull/176) - Flowchart subgraphs, direction, and the styling the other builders have [#&#8203;181](https://github.com/nao1215/markdown/pull/181) ##### Fixed: output that did not render Each of these replaced output that mermaid refused to draw or that GitHub read as something other than what the call described. Labels that already rendered are untouched, which the golden files enforce. - A quotation mark lost a flowchart, a pie chart, an entity relationship diagram [#&#8203;157](https://github.com/nao1215/markdown/pull/157) [#&#8203;159](https://github.com/nao1215/markdown/pull/159) [#&#8203;161](https://github.com/nao1215/markdown/pull/161) - A colon cut a gantt task name short, ended a class statement, ended a state note [#&#8203;162](https://github.com/nao1215/markdown/pull/162) [#&#8203;163](https://github.com/nao1215/markdown/pull/163) [#&#8203;168](https://github.com/nao1215/markdown/pull/168) - Each user journey field lost a different set of characters, including a comma that split one actor into two [#&#8203;164](https://github.com/nao1215/markdown/pull/164) - Shape delimiters lost a mindmap; a kanban card label was rejected rather than encoded [#&#8203;166](https://github.com/nao1215/markdown/pull/166) [#&#8203;167](https://github.com/nao1215/markdown/pull/167) - An xy chart label of non-ASCII text went out unquoted and lost the chart [#&#8203;165](https://github.com/nao1215/markdown/pull/165) - A sequence diagram read a hyphen in a participant name as an arrow, and a "#" in a message as a comment [#&#8203;169](https://github.com/nao1215/markdown/pull/169) - A quadrant chart could not read most punctuation in any of its labels [#&#8203;170](https://github.com/nao1215/markdown/pull/170) - Front matter titles are quoted, and control characters in them escaped, so YAML cannot swallow a title [#&#8203;117](https://github.com/nao1215/markdown/pull/117) - Table alignment, nil writers, the table of contents indent, and line endings on Windows [#&#8203;110](https://github.com/nao1215/markdown/pull/110) [#&#8203;112](https://github.com/nao1215/markdown/pull/112) - A class annotation is emitted inside the class body, where GitHub accepts it [#&#8203;115](https://github.com/nao1215/markdown/pull/115) - The index links to markdown files relative to itself, with URL separators [#&#8203;142](https://github.com/nao1215/markdown/pull/142) Extending the probe set past the first measurement found more, fixed the same way [#&#8203;187](https://github.com/nao1215/markdown/issues/187): - A raw line break in a label lost or silently corrupted every diagram type that accepts one; it is written as `<br/>`, or as `#&#8203;10;` where that is the form the drawing decodes - A `~`, `@` or `^` lost a quadrant chart; a `+` or `@` lost a sequence diagram from its participant name; a `^` in kanban metadata lost the board - A `<` in a title was eaten by the renderer's sanitizer along with the rest; it is written as `#&#8203;60;` in the title statements that decode it - A timeline colon was drawn as `&:`, a `#` cut a period short, and `%%` lost a whole line — the timeline package was the one type the probe had missed - A backslash in a quoted class, xy chart, packet, block, git graph or requirement string was drawn as `&\`, the half decoded HTML form; it is written as `#&#8203;92;`, which draws the character - An `&`, `<` or `>` in a git graph or xy chart string was drawn as the literal text `&amp;`, `&lt;` or `&gt;`; a `<` in a block label or a requirement name was read as an opening tag and ate the rest; a `"` in a packet field or an xy chart title was drawn as the literal `&quot;` — each is written as the entity form its drawing decodes - The renderer check now asserts, character by character, that everything an edge-case document declares actually reaches the rendered SVG text; parse and render alone had let each of the above ship `mermaid/arch` is the one place a label still cannot carry punctuation: mermaid's `architecture-beta` grammar accepts only `[A-Za-z0-9_ ]` and refuses its own escape form, so there is nothing to encode to. The package documentation says so [#&#8203;171](https://github.com/nao1215/markdown/pull/171). A sankey node name refuses `<`, tab and zero-width characters along with non-ASCII text, and a front matter title draws every escape of `<` as literal text, so those two limits are documented the same way. A mermaid title that is not valid UTF-8 is reinterpreted rather than mangled, which is documented rather than changed [#&#8203;155](https://github.com/nao1215/markdown/pull/155). ##### Documentation - A godoc example for every exported symbol, 705 of them, each output-verified [#&#8203;174](https://github.com/nao1215/markdown/pull/174) [#&#8203;175](https://github.com/nao1215/markdown/pull/175) - [doc/v1-api-audit.md](doc/v1-api-audit.md): every exported symbol and its verdict [#&#8203;176](https://github.com/nao1215/markdown/pull/176) - Every README example reproduces the file it links to, and a test keeps it that way [#&#8203;173](https://github.com/nao1215/markdown/pull/173) ##### Tests and CI - Golden files pin the output of every builder [#&#8203;135](https://github.com/nao1215/markdown/pull/135) - The generated markdown is read back with a GFM parser [#&#8203;143](https://github.com/nao1215/markdown/pull/143) - Fuzzing over the quoting and escaping boundaries, with a parser as the oracle [#&#8203;145](https://github.com/nao1215/markdown/pull/145) - Every committed mermaid diagram is drawn by the real renderer in CI, including one document per diagram type whose every label holds the punctuation that type can carry [#&#8203;147](https://github.com/nao1215/markdown/pull/147) [#&#8203;172](https://github.com/nao1215/markdown/pull/172) - Pull requests are rejected for incompatible API changes [#&#8203;138](https://github.com/nao1215/markdown/pull/138) [#&#8203;152](https://github.com/nao1215/markdown/pull/152) - The error handling every builder shares is pinned in one place [#&#8203;141](https://github.com/nao1215/markdown/pull/141) - Tests live in one file per package rather than one per viewpoint [#&#8203;154](https://github.com/nao1215/markdown/pull/154) ##### Upgrading from v0.13.0 **Your code needs no change.** The exported API gained 112 symbols and lost none; the only signature that changed is `NewMarkdown`, which gained a variadic options parameter, so every existing call site still compiles. Only code that assigned the function itself to a `func(io.Writer) *Markdown` variable is affected. **Your regenerated documents will differ**, and not only where the old output was broken. Running the v0.13.0 sample generators unchanged against this release gives these differences: | change | what it affects | | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | every document now ends with a line ending | **every document** | | a mermaid front matter title is quoted: `title: Checkout` becomes `title: "Checkout"` | diagrams whose title goes in front matter, which is not the ones writing a `title` statement | | a block diagram title moves from a `title` statement into the front matter | block diagrams with a title | | a class annotation moves inside the class body | class diagrams using `<<Interface>>` | | the label escaping listed above | only labels holding the punctuation concerned, which did not render before | The first is the widest: nothing about it was broken, and it changes every file. It is deliberate. markdownlint's MD047 requires the trailing line ending, and without it a second document appended to the same writer splices its first line onto the last line of the first. The rest each replaced output that mermaid would not draw or that YAML read as something other than the title given. Expect a one-line diff in every generated file, and review the diagram titles once. After that, v1.x holds the bytes still. </details> --- ### Configuration 📅 **Schedule**: (UTC) - Branch creation - At any time (no schedule defined) - Automerge - At any time (no schedule defined) 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box --- This PR has been generated by [Mend Renovate CLI](https://github.com/renovatebot/renovate). <!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0NC4xNC4xMiIsInVwZGF0ZWRJblZlciI6IjQ0LjEwNC4wIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->
chore(deps): update module github.com/nao1215/markdown to v1
Some checks failed
renovate/artifacts Artifact file update failure
01f9c6513b
Author
Collaborator

⚠️ Artifact update problem

Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is.

♻ Renovate will retry this branch, including artifacts, only when one of the following happens:

  • any of the package files in this branch needs updating, or
  • the branch becomes conflicted, or
  • you click the rebase/retry checkbox if found above, or
  • you rename this PR's title to start with "rebase!" to trigger it manually

The artifact failure details are included below:

File name: go.sum
[08:59:39.131] INFO (204): Installing tool golang@1.27.1...
[08:59:39.145] ERROR (204): Unexpected error found when calling "Symbol(construct)" @postConstruct decorated method on class "VersionService"
[08:59:39.145] FATAL (204): Install tool golang failed in 18ms.

### ⚠️ Artifact update problem Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is. ♻ Renovate will retry this branch, including artifacts, only when one of the following happens: - any of the package files in this branch needs updating, or - the branch becomes conflicted, or - you click the rebase/retry checkbox if found above, or - you rename this PR's title to start with "rebase!" to trigger it manually The artifact failure details are included below: ##### File name: go.sum ``` [08:59:39.131] INFO (204): Installing tool golang@1.27.1... [08:59:39.145] ERROR (204): Unexpected error found when calling "Symbol(construct)" @postConstruct decorated method on class "VersionService" [08:59:39.145] FATAL (204): Install tool golang failed in 18ms. ```
renovate-bot force-pushed renovate/github.com-nao1215-markdown-1.x from 01f9c6513b
Some checks failed
renovate/artifacts Artifact file update failure
to 4d6a0b1f34
Some checks failed
renovate/artifacts Artifact file update failure
2026-08-16 23:27:29 -04:00
Compare
renovate-bot force-pushed renovate/github.com-nao1215-markdown-1.x from 4d6a0b1f34
Some checks failed
renovate/artifacts Artifact file update failure
to 9466a13a14
Some checks failed
renovate/artifacts Artifact file update failure
2026-09-16 10:41:51 -04:00
Compare
renovate-bot force-pushed renovate/github.com-nao1215-markdown-1.x from 9466a13a14
Some checks failed
renovate/artifacts Artifact file update failure
to 71c1e32d74
Some checks failed
renovate/artifacts Artifact file update failure
2026-09-21 04:59:52 -04:00
Compare
Some checks failed
renovate/artifacts Artifact file update failure
This pull request can be merged automatically.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin renovate/github.com-nao1215-markdown-1.x:renovate/github.com-nao1215-markdown-1.x
git switch renovate/github.com-nao1215-markdown-1.x

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main
git merge --no-ff renovate/github.com-nao1215-markdown-1.x
git switch renovate/github.com-nao1215-markdown-1.x
git rebase main
git switch main
git merge --ff-only renovate/github.com-nao1215-markdown-1.x
git switch renovate/github.com-nao1215-markdown-1.x
git rebase main
git switch main
git merge --no-ff renovate/github.com-nao1215-markdown-1.x
git switch main
git merge --squash renovate/github.com-nao1215-markdown-1.x
git switch main
git merge --ff-only renovate/github.com-nao1215-markdown-1.x
git switch main
git merge renovate/github.com-nao1215-markdown-1.x
git push origin main
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
maxpeterkaya/changelog!30
No description provided.