# Bare URL in markdown loses its link

**URL:** <https://talk.jekyllrb.com/t/bare-url-in-markdown-loses-its-link/7602>\
**Category:** Help\
**Created:** [August 23, 2022, 12:55pm UTC](https://talk.jekyllrb.com/t/bare-url-in-markdown-loses-its-link/7602 "2022-08-23T12:55:45Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![tripleee](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/tripleee/32/4840_2.png) [@tripleee](https://talk.jekyllrb.com/u/tripleee)\
**Post date:** [August 23, 2022, 12:55pm UTC](https://talk.jekyllrb.com/t/bare-url-in-markdown-loses-its-link/7602/1 "2022-08-23T12:55:45Z")

</div>

I created a basic site using Jekyll. It has a couple of bullet points whose text is a link to another URL.  
In the markdown source, these URLs are displayed as links, but in the rendered site, they lost the clickable link property.

I quickly fixed them by changing the markdown to use an explicit link, like

`* [https://example.com/destination](https://example.com/destination)`

but obviously this is unattractive and possibly hard to discover for users who are not very familiar with markdown.

Is this a know bug? If not, should I file an issue at [Issues · jekyll/jekyll · GitHub](https://github.com/jekyll/jekyll/issues/) or somewhere else?

---

<div class="post-metadata">

**Author:** ![rdyar](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/rdyar/32/710_2.png) [@rdyar](https://talk.jekyllrb.com/u/rdyar)\
**Post date:** [August 23, 2022, 3:29pm UTC](https://talk.jekyllrb.com/t/bare-url-in-markdown-loses-its-link/7602/2 "2022-08-23T15:29:15Z")

</div>

how did you do the markdown code for the link? with just `http://mysite.com`?

---

<div class="post-metadata">

**Author:** ![tripleee](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/tripleee/32/4840_2.png) [@tripleee](https://talk.jekyllrb.com/u/tripleee)\
**Post date:** [August 23, 2022, 4:02pm UTC](https://talk.jekyllrb.com/t/bare-url-in-markdown-loses-its-link/7602/3 "2022-08-23T16:02:14Z")

</div>

No formatting at all. Here is the source before I fixed it; at the time, the URLs were rendered as clickable links by Github, but the links disappeared and left only the text when the site was built and deployed.

> <https://github.com/jekyll-pages/minimal/commit/d83c2c774074b653fb86f3198f24106db26e6bea>

(The link is to the diff where I edited the file to add the links; sorry, I can’t find a good way to link to my fork’s contents at this particular commit, perhaps because I’m on mobile.)

---

<div class="post-metadata">

**Author:** ![BillRaymond](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/billraymond/32/5963_2.png) [@BillRaymond](https://talk.jekyllrb.com/u/BillRaymond)\
**Post date:** [August 23, 2022, 6:13pm UTC](https://talk.jekyllrb.com/t/bare-url-in-markdown-loses-its-link/7602/4 "2022-08-23T18:13:53Z")

</div>

While I appreciate your sharing the issue and sharing the new commit, I would appreciate it if you just share what you type in markdown vs what displays in the browser source. Is the link contained within your site or does it point to another site?

I looked at your `_config.yml` and figure it is the age-old issue of needing to add the `baseurl` and `url` in there.

Try adding the following lines to your `/_config.yml` file:

```auto
baseurl: "/minimal" # the subpath of your site, e.g. /blog
url: "https://jekyll-pages.github.io/" # the base hostname & protocol for your site, e.g. http://example.com

```

Of course, if you are hosting the site on some other URL, modify those as needed.

Let’s say you want to link to a file on your website called `/docs/doc1.html`.

If this does not work:

```auto
[Doc1](/docs/doc1.html)

```

Then use Liquid to type:

```auto
[Doc1]({{ "/docs/doc1.html" | relative_url }})

```

---

<div class="post-metadata">

**Author:** ![tripleee](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/tripleee/32/4840_2.png) [@tripleee](https://talk.jekyllrb.com/u/tripleee)\
**Post date:** [August 23, 2022, 6:52pm UTC](https://talk.jekyllrb.com/t/bare-url-in-markdown-loses-its-link/7602/5 "2022-08-23T18:52:19Z")

</div>

The URLs are full URLs to external sites. The markdown is as simple as it can possibly be;

```auto
* https://url1.example.com/
  - description
* https://url2.example.com/
  - another description

```

I don’t see how the `baseurl` configuration is relevant here; and if it is indeed required, I would regard _that_ as a bug.

The fixed (or rather, workarounded) version is

```auto
* [https://url1.example.com/](https://url1.example.com/)
  - description
* [https://url2.example.com/](https://url2.example.com/)
  - another description

```

This is already more text than the actual source of the entire site.

The actual site source with its very brief history is at [GitHub - tripleee/triple.ee: My humble contribution to the world wide landfill](https://github.com/tripleee/triple.ee)

---

<div class="post-metadata">

**Author:** ![rdyar](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/rdyar/32/710_2.png) [@rdyar](https://talk.jekyllrb.com/u/rdyar)\
**Post date:** [August 24, 2022, 12:05am UTC](https://talk.jekyllrb.com/t/bare-url-in-markdown-loses-its-link/7602/6 "2022-08-24T00:05:25Z")

</div>

try surrounding the link with angle brackets like `<http://coolsite.com>`

Jekyll uses Kramdown, this is from their docs - automatic links - which I think is what you are looking for, more or less:

> **[Syntax | kramdown](https://kramdown.gettalong.org/syntax.html#automatic-links)**
>
> kramdown is a fast, pure-Ruby Markdown-superset converter

GH uses its own flavor of markdown which seems to allow just typing in a url.

---

<div class="post-metadata">

**Author:** ![tripleee](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/tripleee/32/4840_2.png) [@tripleee](https://talk.jekyllrb.com/u/tripleee)\
**Post date:** [August 24, 2022, 4:23am UTC](https://talk.jekyllrb.com/t/bare-url-in-markdown-loses-its-link/7602/7 "2022-08-24T04:23:21Z")

</div>

Thanks, that worked. I’m still not entirely happy that what I see on Github is not what ends up being published, but this solved my immediate problem. (And for what it’s worth, the syntax with brokets renders as expected on Github too, so with this fix, I _do_ see exactly what the end result will look like, though of course this fix is not really discoverable.)

---

<div class="post-metadata">

**Author:** ![ReenigneArcher](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/reenignearcher/32/6413_2.png) [@ReenigneArcher](https://talk.jekyllrb.com/u/ReenigneArcher)\
**Post date:** [September 14, 2025, 3:44pm UTC](https://talk.jekyllrb.com/t/bare-url-in-markdown-loses-its-link/7602/8 "2025-09-14T15:44:11Z")

</div>

I would also like a way to automatically create clickable links from raw urls.

I am using kramdown with GFM. While GitHub flavored markdown does support this on GitHub, it appears it doesn’t work in jekyll.

I automate posts from GitHub release notes, for which they do not use standard markdown syntax for the full changelog URL, which results in the URL being rendered as simple text.

 ![image](https://canada1.discourse-cdn.com/flex030/uploads/jekyllrb/original/2X/2/2f505a48fbe6210c210ce3aa7213562b899ea42d.png)

GitHub also makes it challenging to use jekyll extensions that they have not whitelisted, without complicated build scripts.
