Markdown links are not always handled correctly

[raboof]

In Alpakka, we have the link:

Please visit the [Slick documentation for `DatabaseConfig.fromConfig`](http://slick.lightbend.com/doc/3.2.1/api/index.html#slick.jdbc.JdbcBackend$DatabaseFactoryDef@forConfig(String,Config,Driver,ClassLoader):Database) for the full list of things to configure.

which is not rendered correctly (https://developer.lightbend.com/docs/alpakka/current/slick.html?language=java#starting-a-database-session)

[jonas]

Did you try to use source reference?

Please visit the [Slick documentation for `DatabaseConfig.fromConfig`][jdbcbackend-api] for the full list of things to configure.

 [jdbcbackend-api]: (http://slick.lightbend.com/doc/3.2.1/api/index.html#slick.jdbc.JdbcBackend$DatabaseFactoryDef@forConfig(String,Config,Driver,ClassLoader):Database)

[raboof]

Nice, that indeed appears to work! Not super obvious though...