Fixes @doc

Author: joeycarpinelli

Project.toml

@@ -1,7 +1,7 @@
 name = "DocumenterQuarto"
 uuid = "73f83fcb-c367-40db-89b6-8fd94701aaf2"
 authors = ["Joey Carpinelli <joey@loopy.codes>"]
-version = "0.3.0"
+version = "0.3.1"
 
 [deps]
 Dates = "ade2ca70-3891-5945-98fb-dc099432e06a"

docs/src/_static/versions.html

@@ -67,7 +67,7 @@
                         const li = document.createElement('li');
                         const a = document.createElement('a');
                         a.className = 'dropdown-item';
-                        a.href = `../${version}/index.html`;
+                        a.href = `/DocumenterQuarto.jl/${version}/index.html`;
 
                         // Wrap version text in a <code> element
                         const code = document.createElement('code');

src/DocumenterQuarto.jl

@@ -418,9 +418,16 @@ import DocumenterQuarto: @doc
 ```
 """
 macro doc(expr)
+    clean_expr = strip(replace(string(expr), r"#=.*?=#"s => ""))
+    header = Markdown.Header{2}("`$clean_expr`")
     quote
         let docmd = Base.Docs.@doc($expr)
-            DocumenterQuarto.process(docmd)
+            Markdown.MD(
+                $header,
+                Markdown.parse(":::{.callout appearance=\"minimal\"}"),
+                DocumenterQuarto.process(docmd),
+                Markdown.parse(":::")
+            )
         end
     end
 end

test/runtests.jl

@@ -62,9 +62,8 @@ Returns "String".
 f(::String) = "String"
 
 @testset "Macros" begin
-    @test DocumenterQuarto.@doc(_type_instance) == Base.Docs.@doc(_type_instance)
-    @test string(DocumenterQuarto.@doc(f)) == "Returns \"Int\".\n\nReturns \"String\".\n"
-    @test string(DocumenterQuarto.@doc(f(::Int))) == "Returns \"Int\".\n"
-    @test string(DocumenterQuarto.@doc(f(::String))) == "Returns \"String\".\n"
-
+    @test DocumenterQuarto.@doc(_type_instance) isa Markdown.MD
+    @test DocumenterQuarto.@doc(f) isa Markdown.MD
+    @test DocumenterQuarto.@doc(f(::Int)) isa Markdown.MD
+    @test DocumenterQuarto.@doc(f(::String)) isa Markdown.MD
 end