Add markdown linter and formatter to pre-commit

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,24 +1,28 @@
----
-name: "\U0001F41B Bug Report"
+______________________________________________________________________
+
+name: "\\U0001F41B Bug Report"
 about: Report typos, innacuracies or errors to help us improve the napari documentation
 title: ''
 labels: bug
 assignees: ''
 
----
+______________________________________________________________________
 
 ## 🐛 Bug
+
 <!-- A clear and concise description of what the issue is. -->
+
 <!-- Please provide the URL(s) of the page(s) that are problematic. -->
+
 <!-- If you can, please add a screenshot or screen capture: "An image is worth a thousand words!" -->
-<!-- If you have a code sample, error messages, stack traces, please provide it here as well -->
 
+<!-- If you have a code sample, error messages, stack traces, please provide it here as well -->
 
 ## Environment
 
- - Please copy and paste the information at napari info option in help menubar here:
+- Please copy and paste the information at napari info option in help menubar here:
 
- - Any other relevant information:
+- Any other relevant information:
 
 ## Additional context
 

.github/ISSUE_TEMPLATE/new_content.md

@@ -1,15 +1,17 @@
----
-name: "\U0001F4DA New content request"
+______________________________________________________________________
+
+name: "\\U0001F4DA New content request"
 about: Suggest new content pages to be added to the napari documentation
 title: ''
 labels: content
 assignees: ''
 
----
+______________________________________________________________________
 
 ## 📚 New content request
-<!-- A clear and concise description of the content you'd like to see, and why this is important -->
 
+<!-- A clear and concise description of the content you'd like to see, and why this is important -->
 
 ### Outline
+
 <!-- Please include a rough outline of the document you are proposing -->

.github/ISSUE_TEMPLATE/task.md

@@ -1,10 +1,13 @@
----
-name: "\U0001F9F0 Task"
+______________________________________________________________________
+
+name: "\\U0001F9F0 Task"
 about: Submit a proposal/request for improvements to workflows, documentation build or deployment.
 title: ''
 labels: task
 assignees: ''
 
----
+______________________________________________________________________
+
 ## 🧰 Task
+
 <!-- A clear and concise description of the task -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,21 +1,31 @@
 # Description
+
 <!-- What does this pull request (PR) do? Why is it necessary? -->
+
 <!-- Tell us about your new content, improvement, or fix! -->
+
 <!-- If you can, please add an image, or an animation "An image is worth a thousand words!" -->
+
 <!-- You can use https://www.cockos.com/licecap/ or similar to create animations -->
+
 <!-- You can also see a preview of the documentation changes you are submitting by clicking on "Details" to the right of the "Check the rendered docs here!" check on your PR.-->
 
 ## Type of change
+
 <!-- Please delete options that are not relevant. -->
+
 - [ ] Fixes or improves existing content
 - [ ] Adds new content page(s)
 - [ ] Fixes or improves workflow, documentation build or deployment
 
 # References
+
 <!-- What resources, documentation, and guides were used in the creation of this PR? -->
+
 <!-- If this is a fix or otherwise resolves an issue, reference it here with "closes #(issue)" -->
 
 ## Final checklist:
+
 - [ ] My PR is the minimum possible work for the desired functionality
 - [ ] I have commented my code, particularly in hard-to-understand areas
-- [ ] I have added [alt text](https://webaim.org/techniques/alttext/) to new images included in this PR
+- [ ] I have added [alt text](https://webaim.org/techniques/alttext/) to new images included in this PR

.github/TEST_FAIL_TEMPLATE.md

@@ -1,12 +1,12 @@
----
-title: "{{ env.TITLE }}"
-labels: [bug]
----
+______________________________________________________________________
+
+## title: "{{ env.TITLE }}" labels: \[bug\]
+
 The {{ workflow }} workflow failed on {{ date | date("YYYY-MM-DD HH:mm") }} UTC
 
 The most recent failing test was on {{ env.PLATFORM }} py{{ env.PYTHON }} {{ env.BACKEND }}
 with commit: {{ sha }}
 
 Full run: https://github.com/{{ payload.repository.full_name }}/actions/runs/{{ env.RUN_ID }}
 
-(This post will be updated if another test fails, as long as this issue remains open.)
+(This post will be updated if another test fails, as long as this issue remains open.)

.github/missing_translations.md

@@ -1,7 +1,6 @@
----
-title: [Automatic issue] Missing `_.trans()`.
-labels: "good first issue"
----
+______________________________________________________________________
+
+## title: \[Automatic issue\] Missing `_.trans()`. labels: "good first issue"
 
 It looks like one of our test cron detected missing translations.
 You can see the latest output [here](https://github.com/napari/napari/actions/workflows/test_translations.yml).
@@ -11,4 +10,3 @@ You can also Update the cron script to update this issue with better information
 
 Note that this issue will be automatically updated if kept open, or a new one will be created when necessary, if no open
 issue is found and new `_.trans` call are missing.
-

.pre-commit-config.yaml

@@ -3,3 +3,12 @@ repos:
     rev: v4.4.0
     hooks:
     -   id: trailing-whitespace
+-   repo: https://github.com/executablebooks/mdformat
+    rev: 0.7.16  # Use the ref you want to point at
+    hooks:
+    -   id: mdformat
+        # Optionally add plugins
+        args: ["--number"]
+        additional_dependencies:
+        -   mdformat-gfm
+        -   mdformat-black

EULA.md

@@ -7,9 +7,8 @@ https://napari.org.
 
 <!-- Links -->
 
-[napari_installers]: https://napari.org/stable/index.html#installation
-
 <!-- List of EULAs starts here -->
+
 <!--
     Manually collected from the license artifacts found in the conda bundle CI.
     Tip: Most licenses that need to be included are marked with a `LicenseRef-` prefix.
@@ -901,3 +900,5 @@ IF YOU COMPLY WITH THESE LICENSE TERMS, YOU HAVE THE RIGHTS BELOW.
     exclusion or limitation of incidental, consequential or other
     damages.
 ```
+
+[napari_installers]: https://napari.org/stable/index.html#installation

docs/api/index.md

@@ -1,7 +1,8 @@
 (api)=
+
 # API Reference
 
 Information on specific functions, classes, and methods.
 
 ```{tableofcontents}
-```
+```

docs/community/code_of_conduct.md

@@ -1,4 +1,5 @@
 (napari-coc)=
+
 # Code of Conduct
 
 ## Introduction
@@ -23,17 +24,17 @@ We strive to:
 
 5. Be careful in the words that we choose. We are careful and respectful in our communication and we take responsibility for our own speech. Be kind to others. Do not insult or put down other participants. We will not accept harassment or other exclusionary behaviour, such as:
 
-> * Violent threats or language directed against another person.
-> * Sexist, racist, ableist, or otherwise discriminatory jokes and language.
-> * Posting sexually explicit or violent material.
-> * Posting (or threatening to post) other people’s personally identifying information (“doxing”).
-> * Sharing private content, such as emails sent privately or non-publicly, or unlogged forums such as IRC channel history, without the sender’s consent.
-> * Personal insults, especially those using sexist, racist, or ableist terms.
-> * Intentional or repeated misgendering of participants who have explicitly requested to be addressed by specific pronouns.
-> * Unwelcome sexual attention.
-> * Excessive profanity. Please avoid swearwords; people differ greatly in their sensitivity to swearing.
-> * Repeated harassment of others. In general, if someone asks you to stop, then stop.
-> * Advocating for, or encouraging, any of the above behaviour.
+> - Violent threats or language directed against another person.
+> - Sexist, racist, ableist, or otherwise discriminatory jokes and language.
+> - Posting sexually explicit or violent material.
+> - Posting (or threatening to post) other people’s personally identifying information (“doxing”).
+> - Sharing private content, such as emails sent privately or non-publicly, or unlogged forums such as IRC channel history, without the sender’s consent.
+> - Personal insults, especially those using sexist, racist, or ableist terms.
+> - Intentional or repeated misgendering of participants who have explicitly requested to be addressed by specific pronouns.
+> - Unwelcome sexual attention.
+> - Excessive profanity. Please avoid swearwords; people differ greatly in their sensitivity to swearing.
+> - Repeated harassment of others. In general, if someone asks you to stop, then stop.
+> - Advocating for, or encouraging, any of the above behaviour.
 
 ## Diversity statement
 
@@ -53,13 +54,13 @@ For clearly intentional breaches, report those to the Code of Conduct committee
 
 You can report issues to the napari Code of Conduct committee, at [email protected] . Currently, the committee consists of:
 
-* [Juan Nunez-Iglesias](https://github.com/jni) (chair)
-* [Nicholas Sofroniew](https://github.com/sofroniewn)
-* [Kira Evans](https://github.com/kne42)
+- [Juan Nunez-Iglesias](https://github.com/jni) (chair)
+- [Nicholas Sofroniew](https://github.com/sofroniewn)
+- [Kira Evans](https://github.com/kne42)
 
 If your report involves any members of the committee, or if they feel they have a conflict of interest in handling it, then they will recuse themselves from considering your report. Alternatively, if for any reason you feel uncomfortable making a report to the committee, then you can also contact:
 
-* [Charlotte Weaver](https://github.com/csweaver) at [email protected]
+- [Charlotte Weaver](https://github.com/csweaver) at [email protected]
 
 ## Incident reporting resolution & Code of Conduct enforcement
 
@@ -85,5 +86,5 @@ The committee will respond to any report as soon as possible, and at most within
 
 We are thankful to the groups behind the following documents, from which we drew content and inspiration:
 
-* [The SciPy Code of Conduct](https://docs.scipy.org/doc/scipy/dev/conduct/code_of_conduct.html)
-* [The Numpy Code of Conduct](https://numpy.org/code-of-conduct/)
+- [The SciPy Code of Conduct](https://docs.scipy.org/doc/scipy/dev/conduct/code_of_conduct.html)
+- [The Numpy Code of Conduct](https://numpy.org/code-of-conduct/)