diff --git a/.markdownlint.yaml b/.markdownlint.yaml index aeed9f341..a66b569ea 100644 --- a/.markdownlint.yaml +++ b/.markdownlint.yaml @@ -26,29 +26,15 @@ MD033: # , but this doesn't improve readability. MD034: false -# Note: Because this repo started without a linter, the rules below are -# suppressed for compatibility with legacy code, but we should either fix the -# linter errors and remove the exceptions or explicitly choose to ignore the -# rule permanently and move it to the list above with an explanation of why we -# ignore the rule. - # heading-increment/header-increment +# As there are often multiple sections in a page, they don't always sequentially decrement, +# so we allow this MD001: false -# ul-indent -MD007: false -# single-title/single-h1 -MD025: false + # ol-prefix +# Some lists are seperated by multiple lines (for example code blocks in-between) MD029: false -# list-marker-space -MD030: false -# blanks-around-fences -MD031: false -# blanks-around-lists -MD032: false + # no-emphasis-as-heading/no-emphasis-as-header +# Sometimes an emphasis is used inbetween sections, but not actually as a header - so we allow this. MD036: false -# no-space-in-emphasis -MD037: false -# first-line-heading/first-line-h1 -MD041: false diff --git a/blog/2019-02-19-gridsome-05/index.md b/blog/2019-02-19-gridsome-05/index.md index 77d30fe71..25331e2f9 100644 --- a/blog/2019-02-19-gridsome-05/index.md +++ b/blog/2019-02-19-gridsome-05/index.md @@ -17,6 +17,7 @@ Read more about [Filtering data](/docs/filtering-data/) All references in the GraphQL schema has been a one-way relation. This release introduces a new field called `belongsTo` for all content types. The field will list all nodes that have a reference back to the current node which makes it very useful to create taxonomy pages etc. The field can also take the same arguments as a collection. And the `@paginate` directive can be used to automatically paginate the results. For example, this can be used to: + - List blog posts for an author. - List posts for a tag or category. diff --git a/blog/2019-09-17-gridsome-07/index.md b/blog/2019-09-17-gridsome-07/index.md index ef5548f4d..bed430b31 100644 --- a/blog/2019-09-17-gridsome-07/index.md +++ b/blog/2019-09-17-gridsome-07/index.md @@ -21,7 +21,7 @@ With Gridsome 0.7 follows a new plugin called [@gridsome/vue-remark](/plugins/@g Here is a quick overview of how it works: -1) Install the plugin and add configs: +1. Install the plugin and add configs: ```js module.exports = { @@ -38,12 +38,13 @@ module.exports = { ] } ``` + In this example `/content/docs/index.md` will be `website.com/docs/`, and `/content/docs/install-guide.md` will be `website.com/docs/install-guide/`. By default it takes any **.md** files in `baseDir` folder and uses them for file-based routing like [Pages](/docs/pages/) works. You can override this by using a `route` config. -2) Setup a template and include the `` component: +2. Setup a template and include the `` component: ```html