# Create static documentation with Documenter.jl

**URL:** <https://discourse.julialang.org/t/create-static-documentation-with-documenter-jl/66567>\
**Category:** General Usage\
**Created:** [August 17, 2021, 8:05pm UTC](https://discourse.julialang.org/t/create-static-documentation-with-documenter-jl/66567 "2021-08-17T20:05:00Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![mleprovost](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mleprovost/32/7166_2.png) [@mleprovost](https://discourse.julialang.org/u/mleprovost)\
**Post date:** [August 17, 2021, 8:05pm UTC](https://discourse.julialang.org/t/create-static-documentation-with-documenter-jl/66567/1 "2021-08-17T20:05:01Z")

</div>

Hello,

I am using Documenter.jl to write the documentation of a package. I would like to include tutorials with blocks of julia code and output figures. However, some of these tutorials can be quite long to run. Is it possible to include lines of julia code in the markdown file but not execute the actual code?

---

<div class="post-metadata">

**Author:** ![heliosdrm](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/heliosdrm/32/3851_2.png) [@heliosdrm](https://discourse.julialang.org/u/heliosdrm)\
**Post date:** [August 17, 2021, 8:30pm UTC](https://discourse.julialang.org/t/create-static-documentation-with-documenter-jl/66567/2 "2021-08-17T20:30:25Z")

</div>

Of course, just write the code blocks with usual markdown syntax:

````julia
```julia
#code
# ...
```

````

---

<div class="post-metadata">

**Author:** ![mleprovost](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mleprovost/32/7166_2.png) [@mleprovost](https://discourse.julialang.org/u/mleprovost)\
**Post date:** [August 17, 2021, 9:16pm UTC](https://discourse.julialang.org/t/create-static-documentation-with-documenter-jl/66567/3 "2021-08-17T21:16:10Z")

</div>

Thank you for your answer. But the code will appear as commented code in the markdown file. Is it possible to show the code as non-commented code but no execute it when I build the documentation.

---

<div class="post-metadata">

**Author:** ![heliosdrm](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/heliosdrm/32/3851_2.png) [@heliosdrm](https://discourse.julialang.org/u/heliosdrm)\
**Post date:** [August 17, 2021, 9:33pm UTC](https://discourse.julialang.org/t/create-static-documentation-with-documenter-jl/66567/4 "2021-08-17T21:33:58Z")

</div>

My writing the example as commented code is not relevant. You can write any code, with or without comments; it won’t be executed if you just write it as a code block tagged as `julia`. You need to use macros as `@example` or `@repl` to make code blocks executable.

---

<div class="post-metadata">

**Author:** ![mleprovost](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mleprovost/32/7166_2.png) [@mleprovost](https://discourse.julialang.org/u/mleprovost)\
**Post date:** [August 17, 2021, 10:04pm UTC](https://discourse.julialang.org/t/create-static-documentation-with-documenter-jl/66567/5 "2021-08-17T22:04:15Z")

</div>

Thank you for your help!