# Getting warning generated HTML from md file is too big

**URL:** <https://discourse.julialang.org/t/getting-warning-generated-html-from-md-file-is-too-big/128348>\
**Category:** General Usage\
**Tags:** documenterjl\
**Created:** [April 23, 2025, 11:34pm UTC](https://discourse.julialang.org/t/getting-warning-generated-html-from-md-file-is-too-big/128348 "2025-04-23T23:34:54Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![co1emi11er](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/co1emi11er/32/206849_2.png) [@co1emi11er](https://discourse.julialang.org/u/co1emi11er)\
**Post date:** [April 23, 2025, 11:34pm UTC](https://discourse.julialang.org/t/getting-warning-generated-html-from-md-file-is-too-big/128348/1 "2025-04-23T23:34:54Z")

</div>

I am getting the following warning about two of my md files in my docs.

```juliarepl
julia> servedocs()
[ Info: SetupBuildDirectory: setting up build directory.
[ Info: Doctest: running doctests.
[ Info: ExpandTemplates: expanding markdown templates.
[ Info: CrossReferences: building cross-references.
[ Info: CheckDocument: running document checks.
[ Info: Populate: populating indices.
[ Info: RenderDocument: rendering document.
[ Info: HTMLWriter: rendering HTML pages.
┌ Warning: Generated HTML over size_threshold_warn limit: ChapterFFlexure.md
│ Generated file size: 188.83 (KiB)
│ size_threshold_warn: 100.0 (KiB)
│ size_threshold: 200.0 (KiB)
│ HTML file: ChapterFFlexure/index.html
└ @ Documenter.HTMLWriter C:\Users\CMILLER\.julia\packages\Documenter\tbj1p\src\html\HTMLWriter.jl:1868
┌ Warning: Generated HTML over size_threshold_warn limit: Shapes.md
│ Generated file size: 120.92 (KiB)
│ size_threshold_warn: 100.0 (KiB)
│ size_threshold: 200.0 (KiB)
│ HTML file: Shapes/index.html
└ @ Documenter.HTMLWriter C:\Users\CMILLER\.julia\packages\Documenter\tbj1p\src\html\HTMLWriter.jl:1868

```

The size seems too big for what the page is. See [Chapter F - Flexure · AISCSteel.jl](https://co1emi11er2.github.io/AISCSteel.jl/stable/ChapterFFlexure/). Is this too big? If so, then I just have to split it up into more documents?

---

<div class="post-metadata">

**Author:** ![odow](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/odow/32/28685_2.png) [@odow](https://discourse.julialang.org/u/odow)\
**Post date:** [April 24, 2025, 12:34am UTC](https://discourse.julialang.org/t/getting-warning-generated-html-from-md-file-is-too-big/128348/2 "2025-04-24T00:34:29Z")

</div>

You can opt-out of the size check. See:

> <https://github.com/jump-dev/JuMP.jl/blob/4e7832dff39def2cb621ac2b05ecd66feea2d2e1/docs/make.jl#L635-L648>

The warning is a sanity check for people accidentally including massive outputs.

---

<div class="post-metadata">

**Author:** ![goerz](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/goerz/32/3269_2.png) [@goerz](https://discourse.julialang.org/u/goerz)\
**Post date:** [April 24, 2025, 12:40am UTC](https://discourse.julialang.org/t/getting-warning-generated-html-from-md-file-is-too-big/128348/3 "2025-04-24T00:40:40Z")

</div>

> [@co1emi11er](#):
>
> I just have to split it up into more documents?

No, you don’t have to… you could just increase the limits for the warning. Your documentation seems fine to me. The warning is just to prevent situations where pages get too large _accidentally_, and is somewhat arbitrary. As long as you’re setting things up deliberately, it should be fine (up to a point)

---

<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:** [April 24, 2025, 6:43am UTC](https://discourse.julialang.org/t/getting-warning-generated-html-from-md-file-is-too-big/128348/5 "2025-04-24T06:43:33Z")

</div>

I think the safeguard is great to not accidentally have an ascii output of some binary file. To add to the previous answers, a concrete example how to raise the limits is

> <https://github.com/JuliaManifolds/Manopt.jl/blob/a65e694ed812164a931e91f2b69cb261a0665135/docs/make.jl#L146-L152>

That way you can have a bit longer pages or even some longer lists, raise the limit carefully but still have a safeguard to not accidentally bloat your docs.
