# DocumenterCodeBlocks.jl announcement

**URL:** <https://discourse.julialang.org/t/documentercodeblocks-jl-announcement/138552>\
**Category:** Package Announcements\
**Tags:** documentation, documenter\
**Created:** [July 31, 2026, 6:27pm UTC](https://discourse.julialang.org/t/documentercodeblocks-jl-announcement/138552 "2026-07-31T18:27:40Z")\
**Posts on this page:** 6\
**Page:** 2

<div class="post-metadata">

**Author:** ![kellertuer](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kellertuer/32/220707_2.png) [@kellertuer](https://discourse.julialang.org/u/kellertuer)\
**Post date:** [August 14, 2026, 5:05pm UTC](https://discourse.julialang.org/t/documentercodeblocks-jl-announcement/138552/21 "2026-08-14T17:05:33Z")

</div>

That looks neat! I did start using CodeBlocks and would not switch to Vitepress for now; but having a fancy landing page would be very neat!

---

<div class="post-metadata">

**Author:** ![fredrikekre](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/fredrikekre/32/1688_2.png) [@fredrikekre](https://discourse.julialang.org/u/fredrikekre)\
**Post date:** [August 14, 2026, 7:08pm UTC](https://discourse.julialang.org/t/documentercodeblocks-jl-announcement/138552/22 "2026-08-14T19:08:51Z")

</div>

Prototype here: [External documentation links via DocumenterInterLinks inventories - Pull Request #15 - fredrikekre/DocumenterCodeBlocks.jl - GitHub](https://github.com/fredrikekre/DocumenterCodeBlocks.jl/pull/15), looks like this:

 ![635647258-99460c16-7e08-4543-9c04-481f0751c905](https://global.discourse-cdn.com/julialang/original/3X/b/e/beec20554b97227dfcfb5462b5d1b03712426d5f.png)

---

<div class="post-metadata">

**Author:** ![kellertuer](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kellertuer/32/220707_2.png) [@kellertuer](https://discourse.julialang.org/u/kellertuer)\
**Post date:** [August 16, 2026, 5:15pm UTC](https://discourse.julialang.org/t/documentercodeblocks-jl-announcement/138552/23 "2026-08-16T17:15:49Z")

</div>

I am very much looking forward to trying the Interlinks – I am a huge fan of those.

I have one question regarding the line numbers. On my PR, I noticed, e.g. at [States · Manopt.jl](https://manoptjl.org/previews/PR630/commons/states/#Manopt.CoordinatesNormalSystemState) That the first line of the docs mentioning the single type or (later on that page the) function does not have a line number. Constructors however – have line numbers. Here even an example with a few lines, but also the ones with just one line

 ![Screenshot 2026-08-16 at 19.12.30](https://global.discourse-cdn.com/julialang/original/3X/c/3/c3a57adf9eafacf8c5b9361290d9b22c04c98bff.png)

would it be possible to have an option for a single code block (like the very first one) to deactivate line numbers. I would use that for constructors only probably. Otherwise I really like the line numbers.  
(Interlinks – btw – would even link the abstract manifold, maybe even the rand – super cool!)

---

<div class="post-metadata">

**Author:** ![fredrikekre](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/fredrikekre/32/1688_2.png) [@fredrikekre](https://discourse.julialang.org/u/fredrikekre)\
**Post date:** [August 20, 2026, 2:54pm UTC](https://discourse.julialang.org/t/documentercodeblocks-jl-announcement/138552/24 "2026-08-20T14:54:56Z")

</div>

Version 1.4.0 is released which enables copying the permalink when you click the button in the right corner. Also contains some bugfixes to the selection of first sentence in the docstring as the tooltip.

> [@kellertuer](#):
>
> That the first line of the docs mentioning the single type or (later on that page the) function does not have a line number. Constructors however – have line numbers.

It is just the first code block which is special cased since it is usually just a single line signature. There is no special case for what the content in the block actually is. IMO it doesn’t look strange at all to have numbers in the block you talk about.

---

<div class="post-metadata">

**Author:** ![kellertuer](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kellertuer/32/220707_2.png) [@kellertuer](https://discourse.julialang.org/u/kellertuer)\
**Post date:** [August 20, 2026, 3:04pm UTC](https://discourse.julialang.org/t/documentercodeblocks-jl-announcement/138552/25 "2026-08-20T15:04:06Z")

</div>

Strange might be a subjective experience here.

I think for multiline constructors line numbers are probably fine.  
The markup also changes a bit I think (between the first line and the constructor)?

For single-line constructors the 1 upfront is a bit strange.

So maybe something like “unless it is a continued counting of line numbers” (cool feature btw!) a “single line code block” could also skip its line number – might be nice?

Otherwise it is a bit similar to an enumeration with just

1. one point

(and sure, also that is not objectively something wrong, just subjectively.)

---

<div class="post-metadata">

**Author:** ![j-fu](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/j-fu/32/11373_2.png) [@j-fu](https://discourse.julialang.org/u/j-fu)\
**Post date:** [September 8, 2026, 4:36pm UTC](https://discourse.julialang.org/t/documentercodeblocks-jl-announcement/138552/26 "2026-09-08T16:36:01Z")

</div>

Another prototype: [Make documenter output compatible to DocumenterCodeBlocks - Pull Request #230 - JuliaPluto/PlutoStaticHTML.jl - GitHub](https://github.com/JuliaPluto/PlutoStaticHTML.jl/pull/230)

[Previous page](https://discourse.julialang.org/t/documentercodeblocks-jl-announcement/138552.md?page=1)