Skip to content

Commit

Permalink
Create include_readme_in_index.md
Browse files Browse the repository at this point in the history
  • Loading branch information
williln authored Jul 8, 2024
1 parent f1d055d commit 47a3775
Showing 1 changed file with 23 additions and 0 deletions.
23 changes: 23 additions & 0 deletions mkdocs/include_readme_in_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# Including your project's README on your MkDocs index page

## Links

- [mkdocs-include-markdown-plugin](https://pypi.org/project/mkdocs-include-markdown-plugin/)

## Instructions

1. `pip install mkdocs-include-markdown-plugin`
2. Add to your `mkdocs.yml`:

```yaml
plugins:
- include-markdown
```
3. Add to your `docs/index.md`:

```md
{% include-markdown "../README.md" %}
```

You can configure a lot about how this works, or only include snippets or sections, etc. Check out the examples in the link.

0 comments on commit 47a3775

Please sign in to comment.