diff --git a/package.json b/package.json
index 980621f28612..399be812f06e 100644
--- a/package.json
+++ b/package.json
@@ -391,7 +391,7 @@
                 },
                 "python.defaultInterpreterPath": {
                     "default": "python",
-                    "description": "%python.defaultInterpreterPath.description%",
+                    "markdownDescription": "%python.defaultInterpreterPath.description%",
                     "scope": "machine-overridable",
                     "type": "string"
                 },
@@ -415,7 +415,7 @@
                 },
                 "python.experiments.optInto": {
                     "default": [],
-                    "description": "%python.experiments.optInto.description%",
+                    "markdownDescription": "%python.experiments.optInto.description%",
                     "items": {
                         "enum": [
                             "All",
@@ -429,7 +429,7 @@
                 },
                 "python.experiments.optOutFrom": {
                     "default": [],
-                    "description": "%python.experiments.optOutFrom.description%",
+                    "markdownDescription": "%python.experiments.optOutFrom.description%",
                     "items": {
                         "enum": [
                             "All",
diff --git a/package.nls.json b/package.nls.json
index 82d293e74da4..459346744336 100644
--- a/package.nls.json
+++ b/package.nls.json
@@ -27,12 +27,12 @@
     "python.menu.createNewFile.title": "Python File",
     "python.autoComplete.extraPaths.description": "List of paths to libraries and the like that need to be imported by auto complete engine. E.g. when using Google App SDK, the paths are not in system path, hence need to be added into this list.",
     "python.condaPath.description": "Path to the conda executable to use for activation (version 4.4+).",
-    "python.defaultInterpreterPath.description": "Path to default Python to use when extension loads up for the first time, no longer used once an interpreter is selected for the workspace. See https://aka.ms/AAfekmf to understand when this is used",
+    "python.defaultInterpreterPath.description": "Path to default Python to use when extension loads up for the first time, no longer used once an interpreter is selected for the workspace. See [here](https://aka.ms/AAfekmf) to understand when this is used",
     "python.diagnostics.sourceMapsEnabled.description": "Enable source map support for meaningful stack traces in error logs.",
     "python.envFile.description": "Absolute path to a file containing environment variable definitions.",
     "python.experiments.enabled.description": "Enables A/B tests experiments in the Python extension. If enabled, you may get included in proposed enhancements and/or features.",
-    "python.experiments.optInto.description": "List of experiment to opt into. If empty, user is assigned the default experiment groups. See https://github.com/microsoft/vscode-python/wiki/AB-Experiments for more details.",
-    "python.experiments.optOutFrom.description": "List of experiment to opt out of. If empty, user is assigned the default experiment groups. See https://github.com/microsoft/vscode-python/wiki/AB-Experiments for more details.",
+    "python.experiments.optInto.description": "List of experiment to opt into. If empty, user is assigned the default experiment groups. See [here](https://github.com/microsoft/vscode-python/wiki/AB-Experiments) for more details.",
+    "python.experiments.optOutFrom.description": "List of experiment to opt out of. If empty, user is assigned the default experiment groups. See [here](https://github.com/microsoft/vscode-python/wiki/AB-Experiments) for more details.",
     "python.formatting.autopep8Args.description": "Arguments passed in. Each argument is a separate item in the array.",
     "python.formatting.autopep8Path.description": "Path to autopep8, you can use a custom version of autopep8 by modifying this setting to include the full path.",
     "python.formatting.blackArgs.description": "Arguments passed in. Each argument is a separate item in the array.",
@@ -113,6 +113,6 @@
     "python.testing.unittestEnabled.description": "Enable testing using unittest.",
     "python.venvFolders.description": "Folders in your home directory to look into for virtual environments (supports pyenv, direnv and virtualenvwrapper by default).",
     "python.venvPath.description": "Path to folder with a list of Virtual Environments (e.g. ~/.pyenv, ~/Envs, ~/.virtualenvs).",
-    "python.sortImports.args.deprecationMessage": "This setting will be removed soon. Use `isort.args` instead.",
-    "python.sortImports.path.deprecationMessage": "This setting will be removed soon. Use `isort.path` instead."
+    "python.sortImports.args.deprecationMessage": "This setting will be removed soon. Use 'isort.args' instead.",
+    "python.sortImports.path.deprecationMessage": "This setting will be removed soon. Use 'isort.path' instead."
 }