feat!: render_docs() renders to gfm output

NEWS.md

@@ -11,6 +11,10 @@
 * Files stored in `man/figures` (such as `lifecycle` badges) are now properly
   included by `render_docs()` (#321).
 
+* `render_docs()` now renders to Github-flavored markdown (`gfm`) that seems
+  to be used by all docs generators used by `altdoc`. This enables for
+  instance a better support for footnotes (#332).
+
 ### Bug fixes
 
 * Fix a `quarto_website` rendering failure when the package being rendered has

R/qmd2md.R

@@ -21,7 +21,7 @@
         out <- try(
             quarto::quarto_render(
                 input = path.expand(tar_file),
-                output_format = "md",
+                output_format = "gfm",
                 quiet = FALSE,
                 as_job = FALSE
             ),
@@ -33,7 +33,7 @@
         out <- evaluate::evaluate(
             'quarto::quarto_render(
       input = path.expand(tar_file),
-      output_format = "md",
+      output_format = "gfm",
       quiet = FALSE,
       as_job = FALSE,
     )',