Remove `@raw html` decorations if target is Jupyter notebook (#223)

docs/src/documenter.md

@@ -45,6 +45,16 @@ if we set `documenter = true`:
   \int f dx
   $$
   ```
+- Whereas Documenter requires HTML blocks to be escaped
+  ````
+  ```@raw html
+  <tag>...</tag>
+  ```
+  ````
+  the output to a notebook markdown cell will be raw HTML
+  ```
+  <tag>...</tag>
+  ```
 
 ### [`Literate.script`](@ref):
 - Documenter style `@ref`s and `@id` will be removed. This means that you can use

src/Literate.jl

@@ -184,6 +184,8 @@ function replace_default(content, sym;
         # Replace Markdown stdlib math environments
         push!(repls, r"```math(.*?)```"s => s"$$\1$$")
         push!(repls, r"(?<!`)``([^`]+?)``(?!`)" => s"$\1$")
+        # Remove Documenter escape sequence around HTML
+        push!(repls, r"```@raw(\h+)html(.*?)```"s => s"\2")
     else # sym === :jl
         push!(repls, r"^#(!md|!nb|jl) "m => "")    # remove leading #!md, #!nb, and #jl
         push!(repls, r" #(!md|!nb|jl)$"m => "")    # remove trailing #!md, #!nb, and #jl

test/runtests.jl

@@ -234,6 +234,11 @@ content = """
         ## Indented comment
     end
 
+    # Some inline html
+    # ```@raw html
+    #   <a href="https://github.com/fredrikekre/Literate.jl">Literate.jl</a>
+    # ```
+
     # Semicolon output supression
     1 + 1;
 
@@ -600,6 +605,11 @@ end end
             end
             ````
 
+            Some inline html
+            ```@raw html
+              <a href="https://github.com/fredrikekre/Literate.jl">Literate.jl</a>
+            ```
+
             Semicolon output supression
 
             ````@example inputfile
@@ -1025,6 +1035,14 @@ end end
                ]
             """,
 
+            """
+               "source": [
+                "Some inline html\\n",
+                "\\n",
+                "  <a href=\\"https://github.com/fredrikekre/Literate.jl\\">Literate.jl</a>"
+               ]
+            """,
+
             """
                "metadata": {
                 "meta": "data"