# Is there a way that I can use README.md instead of \_index.md?

**URL:** <https://discourse.gohugo.io/t/is-there-a-way-that-i-can-use-readme-md-instead-of-index-md/32812>\
**Category:** support\
**Created:** [May 11, 2021, 3:36am UTC](https://discourse.gohugo.io/t/is-there-a-way-that-i-can-use-readme-md-instead-of-index-md/32812 "2021-05-11T03:36:24Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![rickalex21](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/rickalex21/32/13732_2.png) [@rickalex21](https://discourse.gohugo.io/u/rickalex21)\
**Post date:** [May 11, 2021, 3:36am UTC](https://discourse.gohugo.io/t/is-there-a-way-that-i-can-use-readme-md-instead-of-index-md/32812/1 "2021-05-11T03:36:24Z")

</div>

Is there a setting somewhere where or a way that I can associate README.md as a list page instead of using \_index.md ? What about associating index.md with foo.md for single pages?

Thanks

---

<div class="post-metadata">

**Author:** ![alexandros](https://avatars.discourse-cdn.com/v4/letter/a/ecc23a/32.png) [@alexandros](https://discourse.gohugo.io/u/alexandros)\
**Post date:** [May 11, 2021, 4:50am UTC](https://discourse.gohugo.io/t/is-there-a-way-that-i-can-use-readme-md-instead-of-index-md/32812/2 "2021-05-11T04:50:11Z")

</div>

> [@rickalex21](#):
>
> Is there a setting somewhere where or a way that I can associate README.md as a list page instead of using \_index.md ?

No that is not possible.

> [@rickalex21](#):
>
> What about associating index.md with foo.md for single pages?

[Page Leaf bundles](https://gohugo.io/content-management/page-bundles/#readout) require an `index.md`.

A file called `foo.md` is of course an acceptable content file but it will not be a Page Leaf Bundle.

---

<div class="post-metadata">

**Author:** ![bep](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/bep/32/3332_2.png) [@bep](https://discourse.gohugo.io/u/bep)\
**Post date:** [May 11, 2021, 5:34am UTC](https://discourse.gohugo.io/t/is-there-a-way-that-i-can-use-readme-md-instead-of-index-md/32812/3 "2021-05-11T05:34:57Z")

</div>

> [@alexandros](#):
>
> No that is not possible.

While that is true for the general/practical use case, have a look at this:

> **[GitHub - bep/portable-hugo-links: A test repo to test out the new Markdown...](https://github.com/bep/portable-hugo-links)**
>
> A test repo to test out the new Markdown Render Hooks in Hugo 0.62.0 - GitHub - bep/portable-hugo-links: A test repo to test out the new Markdown Render Hooks in Hugo 0.62.0

> <https://github.com/bep/portable-hugo-links/blob/master/config.toml#L12>

---

<div class="post-metadata">

**Author:** ![alexandros](https://avatars.discourse-cdn.com/v4/letter/a/ecc23a/32.png) [@alexandros](https://discourse.gohugo.io/u/alexandros)\
**Post date:** [May 11, 2021, 6:02am UTC](https://discourse.gohugo.io/t/is-there-a-way-that-i-can-use-readme-md-instead-of-index-md/32812/4 "2021-05-11T06:02:28Z")

</div>

@bep  
You just opened a can of worms IMHO. 🙃

---

<div class="post-metadata">

**Author:** ![rickalex21](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/rickalex21/32/13732_2.png) [@rickalex21](https://discourse.gohugo.io/u/rickalex21)\
**Post date:** [May 11, 2021, 5:57pm UTC](https://discourse.gohugo.io/t/is-there-a-way-that-i-can-use-readme-md-instead-of-index-md/32812/5 "2021-05-11T17:57:18Z")

</div>

It looks like that does work, does it work for nested? I could not get it to work for  
nested but I think this may have something to do with already mounting on the post?  
The README.md does behave as a single page or a list page depending on the  
module.mounts. Not sure if there’s a catch to it? Other than duplicating this for all  
the folders, which is not a big deal:

```auto
[[module.mounts]]
source = "content/README.md"
target = "content/_index.md"

[[module.mounts]]
source = "content/post/README.md"
target = "content/post/_index.md"

[[module.mounts]]
source = "content/post/nested/README.md"
target = "content/post/nested/_index.md"

[[module.mounts]]
source = "content/somefolder/testing.md"
target = "content/somefolder/_index.md"

```

---

<div class="post-metadata">

**Author:** ![jmooring](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/jmooring/32/4214_2.png) [@jmooring](https://discourse.gohugo.io/u/jmooring)\
**Post date:** [August 14, 2021, 2:57pm UTC](https://discourse.gohugo.io/t/is-there-a-way-that-i-can-use-readme-md-instead-of-index-md/32812/8 "2021-08-14T14:57:33Z")

</div>