render spec links in md

Author: mayel

lib/ex_doc/autolink.ex

@@ -99,10 +99,13 @@ defmodule ExDoc.Autolink do
       if app in config.apps do
         path <> ext <> suffix
       else
+        #  TODO: remove this if/when hexdocs.pm starts including .md files
+        ext = ".html"
+
         config.deps
         |> Keyword.get_lazy(app, fn -> base_url <> "#{app}" end)
         |> String.trim_trailing("/")
-        |> Kernel.<>("/" <> path <> ".html" <> suffix)
+        |> Kernel.<>("/" <> path <> ext <> suffix)
       end
     else
       path <> ext <> suffix

lib/ex_doc/language/elixir.ex

@@ -699,7 +699,11 @@ defmodule ExDoc.Language.Elixir do
         end
 
       if url do
-        ~s[<a href="#{url}">#{ExDoc.Utils.h(call_string)}</a>]
+        if config.ext == ".md" do
+          ~s[\[#{ExDoc.Utils.h(call_string)}\](#{url})]
+        else
+          ~s[<a href="#{url}">#{ExDoc.Utils.h(call_string)}</a>]
+        end
       else
         call_string
       end <> do_typespec(rest, config)

lib/ex_doc/language/erlang.ex

@@ -695,7 +695,11 @@ defmodule ExDoc.Language.Erlang do
         end
 
       if url do
-        ~s|<a href="#{url}">#{string}</a>(|
+        if config.ext == ".md" do
+          ~s|[#{string}\](#{url})(|
+        else
+          ~s|<a href="#{url}">#{string}</a>(|
+        end
       else
         string <> "("
       end