fredrikekre GitHub avatar

DocumenterCodeBlocks.jl

fredrikekre

A Julia package that enhances code blocks in Documenter.jl documentation with line numbers, reference links, tooltips, and syntax highlighting.

Stars

9

7-day growth

No data

Forks

0

Open issues

0

License

MIT

Last updated

2026-07-28

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It adds interactive features like GitHub-style permalinks, hover tooltips, and method-aware reference links to Julia documentation, making navigation and comprehension significantly smoother.

Who it is for

  • Julia package developers using Documenter.jl
  • technical writers creating Julia documentation
  • Julia users who read and interact with docs
  • maintainers of large Julia projects needing better doc navigation

Use cases

  • writing API docs with clickable references to docstrings
  • improving code examples with line permalinks for sharing
  • providing hover tooltips that show signatures and summaries
  • enforcing docstring quality through build-time warnings

Strengths

  • GitHub-style line permalinks and gutter selection
  • arity-aware reference links that jump to the correct method
  • build-time syntax highlighting via JuliaSyntax.jl
  • hover tooltips with method signature and one-line summary

Considerations

  • relies on undocumented Documenter internals, may break on updates
  • only supports Julia code blocks (julia, julia-repl, jldoctest)
  • requires Documenter.jl as a dependency

README quick start

Usage

Description

A Documenter.jl plugin for more flavorful code blocks