Fix visual issues with Discord's new Markdown (#6101)

Co-authored-by: Jakub Kuczys <me@jacken.men>

redbot/cogs/cleanup/cleanup.py

@@ -194,7 +194,7 @@ class Cleanup(commands.Cog):
         """Delete the last X messages matching the specified text in the current channel.
 
         Example:
-            - `[p]cleanup text "test" 5`
+        - `[p]cleanup text "test" 5`
 
         Remember to use double quotes.
 
@@ -254,8 +254,8 @@ class Cleanup(commands.Cog):
         """Delete the last X messages from a specified user in the current channel.
 
         Examples:
-            - `[p]cleanup user @Twentysix 2`
+        - `[p]cleanup user @Twentysix 2`
-            - `[p]cleanup user Red 6`
+        - `[p]cleanup user Red 6`
 
         **Arguments:**
 
@@ -436,7 +436,7 @@ class Cleanup(commands.Cog):
         The first message ID should be the older message and the second one the newer.
 
         Example:
-            - `[p]cleanup between 123456789123456789 987654321987654321`
+        - `[p]cleanup between 123456789123456789 987654321987654321`
 
         **Arguments:**
 
@@ -483,7 +483,7 @@ class Cleanup(commands.Cog):
         """Delete the last X messages in the current channel.
 
         Example:
-            - `[p]cleanup messages 26`
+        - `[p]cleanup messages 26`
 
         **Arguments:**
 
@@ -614,9 +614,9 @@ class Cleanup(commands.Cog):
         it is used for pattern matching - only messages containing the given text will be deleted.
 
         Examples:
-            - `[p]cleanup self 6`
+        - `[p]cleanup self 6`
-            - `[p]cleanup self 10 Pong`
+        - `[p]cleanup self 10 Pong`
-            - `[p]cleanup self 7 "" True`
+        - `[p]cleanup self 7 "" True`
 
         **Arguments:**
 

redbot/cogs/customcom/customcom.py

@@ -402,7 +402,7 @@ class CustomCommands(commands.Cog):
         """Add a simple custom command.
 
         Example:
-            - `[p]customcom create simple yourcommand Text you want`
+        - `[p]customcom create simple yourcommand Text you want`
 
         **Arguments:**
 
@@ -447,9 +447,9 @@ class CustomCommands(commands.Cog):
         custom command.
 
         Examples:
-            - `[p]customcom cooldown pingrole`
+        - `[p]customcom cooldown pingrole`
-            - `[p]customcom cooldown yourcommand 30`
+        - `[p]customcom cooldown yourcommand 30`
-            - `[p]cc cooldown mycommand 30 guild`
+        - `[p]cc cooldown mycommand 30 guild`
 
         **Arguments:**
 
@@ -492,7 +492,7 @@ class CustomCommands(commands.Cog):
         """Delete a custom command.
 
         Example:
-            - `[p]customcom delete yourcommand`
+        - `[p]customcom delete yourcommand`
 
         **Arguments:**
 
@@ -510,7 +510,7 @@ class CustomCommands(commands.Cog):
         """Edit a custom command.
 
         Example:
-            - `[p]customcom edit yourcommand Text you want`
+        - `[p]customcom edit yourcommand Text you want`
 
         **Arguments:**
 

redbot/cogs/downloader/downloader.py

@@ -486,8 +486,8 @@ class Downloader(commands.Cog):
         Install a group of dependencies using pip.
 
         Examples:
-            - `[p]pipinstall bs4`
+        - `[p]pipinstall bs4`
-            - `[p]pipinstall py-cpuinfo psutil`
+        - `[p]pipinstall py-cpuinfo psutil`
 
         Improper usage of this command can break your bot, be careful.
 
@@ -526,8 +526,8 @@ class Downloader(commands.Cog):
         """Add a new repo.
 
         Examples:
-            - `[p]repo add 26-Cogs https://github.com/Twentysix26/x26-Cogs`
+        - `[p]repo add 26-Cogs https://github.com/Twentysix26/x26-Cogs`
-            - `[p]repo add Laggrons-Dumb-Cogs https://github.com/retke/Laggrons-Dumb-Cogs v3`
+        - `[p]repo add Laggrons-Dumb-Cogs https://github.com/retke/Laggrons-Dumb-Cogs v3`
 
         Repo names can only contain characters A-z, numbers, underscores, hyphens, and dots (but they cannot start or end with a dot).
 
@@ -597,8 +597,8 @@ class Downloader(commands.Cog):
         Remove repos and their files.
 
         Examples:
-            - `[p]repo delete 26-Cogs`
+        - `[p]repo delete 26-Cogs`
-            - `[p]repo delete 26-Cogs Laggrons-Dumb-Cogs`
+        - `[p]repo delete 26-Cogs Laggrons-Dumb-Cogs`
 
         **Arguments**
 
@@ -639,7 +639,7 @@ class Downloader(commands.Cog):
         """Show information about a repo.
 
         Example:
-            - `[p]repo info 26-Cogs`
+        - `[p]repo info 26-Cogs`
 
         **Arguments**
 
@@ -667,9 +667,9 @@ class Downloader(commands.Cog):
         This will *not* update the cogs installed from those repos.
 
         Examples:
-            - `[p]repo update`
+        - `[p]repo update`
-            - `[p]repo update 26-Cogs`
+        - `[p]repo update 26-Cogs`
-            - `[p]repo update 26-Cogs Laggrons-Dumb-Cogs`
+        - `[p]repo update 26-Cogs Laggrons-Dumb-Cogs`
 
         **Arguments**
 
@@ -768,8 +768,8 @@ class Downloader(commands.Cog):
         """Install a cog from the given repo.
 
         Examples:
-            - `[p]cog install 26-Cogs defender`
+        - `[p]cog install 26-Cogs defender`
-            - `[p]cog install Laggrons-Dumb-Cogs say roleinvite`
+        - `[p]cog install Laggrons-Dumb-Cogs say roleinvite`
 
         **Arguments**
 
@@ -792,7 +792,7 @@ class Downloader(commands.Cog):
         Older revisions can be found in the URL bar by [viewing the commit history of any repo](https://cdn.discordapp.com/attachments/133251234164375552/775760247787749406/unknown.png)
 
         Example:
-            - `[p]cog installversion Broken-Repo e798cc268e199612b1316a3d1f193da0770c7016 cog_name`
+        - `[p]cog installversion Broken-Repo e798cc268e199612b1316a3d1f193da0770c7016 cog_name`
 
         **Arguments**
 
@@ -919,8 +919,8 @@ class Downloader(commands.Cog):
         by Downloader.
 
         Examples:
-            - `[p]cog uninstall defender`
+        - `[p]cog uninstall defender`
-            - `[p]cog uninstall say roleinvite`
+        - `[p]cog uninstall say roleinvite`
 
         **Arguments**
 
@@ -990,8 +990,8 @@ class Downloader(commands.Cog):
         """Pin cogs - this will lock cogs on their current version.
 
         Examples:
-            - `[p]cog pin defender`
+        - `[p]cog pin defender`
-            - `[p]cog pin outdated_cog1 outdated_cog2`
+        - `[p]cog pin outdated_cog1 outdated_cog2`
 
         **Arguments**
 
@@ -1025,8 +1025,8 @@ class Downloader(commands.Cog):
         """Unpin cogs - this will remove the update lock from those cogs.
 
         Examples:
-            - `[p]cog unpin defender`
+        - `[p]cog unpin defender`
-            - `[p]cog unpin updated_cog1 updated_cog2`
+        - `[p]cog unpin updated_cog1 updated_cog2`
 
         **Arguments**
 
@@ -1127,10 +1127,10 @@ class Downloader(commands.Cog):
         """Update all cogs, or ones of your choosing.
 
         Examples:
-            - `[p]cog update`
+        - `[p]cog update`
-            - `[p]cog update True`
+        - `[p]cog update True`
-            - `[p]cog update defender`
+        - `[p]cog update defender`
-            - `[p]cog update True defender`
+        - `[p]cog update True defender`
 
         **Arguments**
 
@@ -1148,9 +1148,9 @@ class Downloader(commands.Cog):
         """Update all cogs from repos of your choosing.
 
         Examples:
-            - `[p]cog updateallfromrepos 26-Cogs`
+        - `[p]cog updateallfromrepos 26-Cogs`
-            - `[p]cog updateallfromrepos True 26-Cogs`
+        - `[p]cog updateallfromrepos True 26-Cogs`
-            - `[p]cog updateallfromrepos Laggrons-Dumb-Cogs 26-Cogs`
+        - `[p]cog updateallfromrepos Laggrons-Dumb-Cogs 26-Cogs`
 
         **Arguments**
 
@@ -1179,8 +1179,8 @@ class Downloader(commands.Cog):
         See `[p]cog installversion` for an explanation of `revision`.
 
         Examples:
-            - `[p]cog updatetoversion Broken-Repo e798cc268e199612b1316a3d1f193da0770c7016 cog_name`
+        - `[p]cog updatetoversion Broken-Repo e798cc268e199612b1316a3d1f193da0770c7016 cog_name`
-            - `[p]cog updatetoversion True Broken-Repo 6107c0770ad391f1d3a6131b216991e862cc897e cog_name`
+        - `[p]cog updatetoversion True Broken-Repo 6107c0770ad391f1d3a6131b216991e862cc897e cog_name`
 
         **Arguments**
 
@@ -1319,7 +1319,7 @@ class Downloader(commands.Cog):
         """List all available cogs from a single repo.
 
         Example:
-            - `[p]cog list 26-Cogs`
+        - `[p]cog list 26-Cogs`
 
         **Arguments**
 
@@ -1360,7 +1360,7 @@ class Downloader(commands.Cog):
         """List information about a single cog.
 
         Example:
-            - `[p]cog info 26-Cogs defender`
+        - `[p]cog info 26-Cogs defender`
 
         **Arguments**
 
@@ -1732,7 +1732,7 @@ class Downloader(commands.Cog):
         This will only work with loaded cogs.
 
         Example:
-            - `[p]findcog ping`
+        - `[p]findcog ping`
 
         **Arguments**
 

redbot/cogs/economy/economy.py

@@ -185,8 +185,8 @@ class Economy(commands.Cog):
         """Show the user's account balance.
 
         Example:
-            - `[p]bank balance`
+        - `[p]bank balance`
-            - `[p]bank balance @Twentysix`
+        - `[p]bank balance @Twentysix`
 
         **Arguments**
 
@@ -211,7 +211,7 @@ class Economy(commands.Cog):
         This will come out of your balance, so make sure you have enough.
 
         Example:
-            - `[p]bank transfer @Twentysix 500`
+        - `[p]bank transfer @Twentysix 500`
 
         **Arguments**
 
@@ -244,9 +244,9 @@ class Economy(commands.Cog):
         Putting + or - signs before the amount will add/remove currency on the user's bank account instead.
 
         Examples:
-            - `[p]bank set @Twentysix 26` - Sets balance to 26
+        - `[p]bank set @Twentysix 26` - Sets balance to 26
-            - `[p]bank set @Twentysix +2` - Increases balance by 2
+        - `[p]bank set @Twentysix +2` - Increases balance by 2
-            - `[p]bank set @Twentysix -6` - Decreases balance by 6
+        - `[p]bank set @Twentysix -6` - Decreases balance by 6
 
         **Arguments**
 
@@ -412,9 +412,9 @@ class Economy(commands.Cog):
         Defaults to top 10.
 
         Examples:
-            - `[p]leaderboard`
+        - `[p]leaderboard`
-            - `[p]leaderboard 50` - Shows the top 50 instead of top 10.
+        - `[p]leaderboard 50` - Shows the top 50 instead of top 10.
-            - `[p]leaderboard 100 yes` - Shows the top 100 from all servers.
+        - `[p]leaderboard 100 yes` - Shows the top 100 from all servers.
 
         **Arguments**
 
@@ -535,7 +535,7 @@ class Economy(commands.Cog):
         """Use the slot machine.
 
         Example:
-            - `[p]slot 50`
+        - `[p]slot 50`
 
         **Arguments**
 
@@ -700,7 +700,7 @@ class Economy(commands.Cog):
         """Set the minimum slot machine bid.
 
         Example:
-            - `[p]economyset slotmin 10`
+        - `[p]economyset slotmin 10`
 
         **Arguments**
 
@@ -735,7 +735,7 @@ class Economy(commands.Cog):
         """Set the maximum slot machine bid.
 
         Example:
-            - `[p]economyset slotmax 50`
+        - `[p]economyset slotmax 50`
 
         **Arguments**
 
@@ -772,8 +772,8 @@ class Economy(commands.Cog):
         """Set the cooldown for the slot machine.
 
         Examples:
-            - `[p]economyset slottime 10`
+        - `[p]economyset slottime 10`
-            - `[p]economyset slottime 10m`
+        - `[p]economyset slottime 10m`
 
         **Arguments**
 
@@ -795,8 +795,8 @@ class Economy(commands.Cog):
         """Set the cooldown for the payday command.
 
         Examples:
-            - `[p]economyset paydaytime 86400`
+        - `[p]economyset paydaytime 86400`
-            - `[p]economyset paydaytime 1d`
+        - `[p]economyset paydaytime 1d`
 
         **Arguments**
 
@@ -820,7 +820,7 @@ class Economy(commands.Cog):
         """Set the amount earned each payday.
 
         Example:
-            - `[p]economyset paydayamount 400`
+        - `[p]economyset paydayamount 400`
 
         **Arguments**
 
@@ -854,7 +854,7 @@ class Economy(commands.Cog):
         Only available when not using a global bank.
 
         Example:
-            - `[p]economyset rolepaydayamount @Members 400`
+        - `[p]economyset rolepaydayamount @Members 400`
 
         **Arguments**
 

redbot/cogs/filter/filter.py

@@ -95,7 +95,7 @@ class Filter(commands.Cog):
         The default name used is *John Doe*.
 
         Example:
-            - `[p]filterset defaultname Missingno`
+        - `[p]filterset defaultname Missingno`
 
         **Arguments:**
 
@@ -115,8 +115,8 @@ class Filter(commands.Cog):
         Set both to zero to disable autoban.
 
         Examples:
-            - `[p]filterset ban 5 5` - Ban users who say 5 filtered words in 5 seconds.
+        - `[p]filterset ban 5 5` - Ban users who say 5 filtered words in 5 seconds.
-            - `[p]filterset ban 2 20` - Ban users who say 2 filtered words in 20 seconds.
+        - `[p]filterset ban 2 20` - Ban users who say 2 filtered words in 20 seconds.
 
         **Arguments:**
 
@@ -264,8 +264,8 @@ class Filter(commands.Cog):
         Use double quotes to add sentences.
 
         Examples:
-            - `[p]filter channel add #channel word1 word2 word3`
+        - `[p]filter channel add #channel word1 word2 word3`
-            - `[p]filter channel add #channel "This is a sentence"`
+        - `[p]filter channel add #channel "This is a sentence"`
 
         **Arguments:**
 
@@ -293,8 +293,8 @@ class Filter(commands.Cog):
         Use double quotes to remove sentences.
 
         Examples:
-            - `[p]filter channel remove #channel word1 word2 word3`
+        - `[p]filter channel remove #channel word1 word2 word3`
-            - `[p]filter channel remove #channel "This is a sentence"`
+        - `[p]filter channel remove #channel "This is a sentence"`
 
         **Arguments:**
 
@@ -315,8 +315,8 @@ class Filter(commands.Cog):
         Use double quotes to add sentences.
 
         Examples:
-            - `[p]filter add word1 word2 word3`
+        - `[p]filter add word1 word2 word3`
-            - `[p]filter add "This is a sentence"`
+        - `[p]filter add "This is a sentence"`
 
         **Arguments:**
 
@@ -337,8 +337,8 @@ class Filter(commands.Cog):
         Use double quotes to remove sentences.
 
         Examples:
-            - `[p]filter remove word1 word2 word3`
+        - `[p]filter remove word1 word2 word3`
-            - `[p]filter remove "This is a sentence"`
+        - `[p]filter remove "This is a sentence"`
 
         **Arguments:**
 

redbot/cogs/mod/kickban.py

@@ -889,9 +889,9 @@ class KickBanMixin(MixinMeta):
         """Unban a user from this server.
 
         Requires specifying the target user's ID. To find this, you may either:
-         1. Copy it from the mod log case (if one was created), or
+        1. Copy it from the mod log case (if one was created), or
-         2. enable developer mode, go to Bans in this server's settings, right-
+        2. Enable Developer Mode, go to Bans in this server's settings, right-click the user and select 'Copy ID'.
-        click the user and select 'Copy ID'."""
+        """
         guild = ctx.guild
         author = ctx.author
         audit_reason = get_audit_reason(ctx.author, reason, shorten=True)

redbot/cogs/mod/settings.py

@@ -473,8 +473,8 @@ class ModSettings(MixinMeta):
         """Delete all stored usernames and nicknames.
 
         Examples:
-            - `[p]modset deletenames` - Did not confirm. Shows the help message.
+        - `[p]modset deletenames` - Did not confirm. Shows the help message.
-            - `[p]modset deletenames yes` - Deletes all stored usernames and nicknames.
+        - `[p]modset deletenames yes` - Deletes all stored usernames and nicknames.
 
         **Arguments**
 

redbot/cogs/permissions/permissions.py

@@ -220,12 +220,12 @@ class Permissions(commands.Cog):
             "checking for the default restrictions of the command.\n"
             "Global rules (set by the owner) are checked first, then rules set for servers. If "
             "multiple global or server rules apply to the case, the order they are checked in is:\n"
-            "  1. Rules about a user.\n"
+            "1. Rules about a user.\n"
-            "  2. Rules about the voice/stage channel a user is connected to.\n"
+            "2. Rules about the voice/stage channel a user is connected to.\n"
-            "  3. Rules about the channel or a parent of the thread a command was issued in.\n"
+            "3. Rules about the channel or a parent of the thread a command was issued in.\n"
-            "  4. Rules about a role the user has (The highest role they have with a rule will be "
+            "4. Rules about a role the user has (The highest role they have with a rule will be "
             "used).\n"
-            "  5. Rules about the server a user is in (Global rules only).\n\n"
+            "5. Rules about the server a user is in (Global rules only).\n\n"
             "For more details, please read the [official documentation]"
             "(https://docs.discord.red/en/stable/cog_permissions.html)."
         )