I am a big fan of `documenter.jl`

! It lets you create beautiful documentations whilst still having full control over its code. Currently, I use the `@example`

syntax extensively, but I would like to `docstrings`

as they provide more rigorous testing. I just so happens that I like to develop examples with notebooks.

So: Is there an automated way to get from Jupyter notebooks to markdown files that contain docstrings? I have read a little bit about `literate.jl`

which goes in the direction.

Here’s an example. Suppose I have written a notebook that looks as follows.

[begin]

[end]

Where I want to end up is :

[begin]

# Computing the 2-norm of a vector

We define a vector `x`

```
julia> using LinearAlgebra
julia> x = collect(1:10)
10-element Array{Int64,1}:
1
2
3
4
5
6
7
8
9
10
```

and compute its norm via

```
julia> norm(x)
19.621416870348583
```

which is equivalent to

```
julia> isequal(norm(x),sqrt(sum(e^2 for e in x)))
true
```

[end]

I have written a file that converts a Jupyter notebook to a markdown with `@example`

blocks that `documenter.jl`

provides. The output of this conversion looks like this

[begin]

```
using LinearAlgebra
x = collect(1:10)
norm(x)
isequal(norm(x),sqrt(sum(e^2 for e in x)))
```

# Computing the 2-norm of a vector

We define a vector `x`

```
using LinearAlgebra
x = collect(1:10)
```

and compute its norm via

```
norm(x)
```

which is equivalent to

```
isequal(norm(x),sqrt(sum(e^2 for e in x)))
```

[end]

Thanks!