jprdonnelly/docs
1
0
Fork 0
mirror of synced 2026-01-08 12:01:53 -05:00
Code Issues Projects Releases Wiki Activity

Merge pull request #29278 from github/repo-sync

Browse Source 
Repo sync
This commit is contained in:
docs-bot
2023-10-19 13:30:22 -07:00
committed by GitHub
parent be0ccf97e6 70e34ef23d
commit 73daf32dbb
1 changed files with 19 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
content/contributing/style-guide-and-content-model/style-guide.md
View File

@@ -189,11 +189,26 @@ Use italics to emphasize words or parts of a sentence. Use emphasis sparingly fo
Avoid using footnotes where possible. Consider instead whether you could use a [callout](#callouts) or present the information in another way. See some [examples of alternatives to footnotes from NICE.org.uk](https://www.nice.org.uk/corporate/ecd6/chapter/footnotes).
If you must use footnotes:
If you must use footnotes, use [Markdown-native footnotes](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#footnotes) (`[^1]`). Footnote markers will be hyperlinked to the footnote reference, which will be listed at the bottom of the page with a backlink to the marker.
- Use numbers. Do not use typographical symbols or special characters.
- Place footnote markers in square brackets: `[1]`.
- Do not use superscript.
Note that regardless of the identifier you use (letters, words), footnotes will render as sequential numbers.
| | Mona | Ursula | Paul | Davy Jones[^1] |
|---|---|---|---|---|
|Favorite pastime| Shipping code | Tricking mermaids[^2] | Predicting sports | Haunting seafarers |
|Uses powers for good| Yes | No | Yes | No |
[^1]: Not to be confused with Davy Jones of The Monkees
[^2]: Also humans
````markdown
| | Mona | Ursula | Paul | Davy Jones[^1] |
|---|---|---|---|---|
|Favorite pastime| Shipping code | Tricking mermaids[^2] | Predicting sports | Haunting seafarers |
|Uses powers for good| Yes | No | Yes | No |
[^1]: Not to be confused with Davy Jones of The Monkees
[^2]: Also humans
````
## Headers