diff --git a/src/vs/workbench/contrib/terminal/common/terminalConfiguration.ts b/src/vs/workbench/contrib/terminal/common/terminalConfiguration.ts
index 8c1aae89da48d..845c769029e31 100644
--- a/src/vs/workbench/contrib/terminal/common/terminalConfiguration.ts
+++ b/src/vs/workbench/contrib/terminal/common/terminalConfiguration.ts
@@ -172,10 +172,10 @@ const terminalConfiguration: IConfigurationNode = {
 			type: 'string'
 		},
 		[TerminalSettingId.FontLigatures]: {
-			description: localize('terminal.integrated.fontLigatures', "Controls whether font ligatures are enabled in the terminal."),
+			markdownDescription: localize('terminal.integrated.fontLigatures', "Controls whether font ligatures are enabled in the terminal. Ligatures will only work if the configured {0} supports them.", `\`#${TerminalSettingId.FontFamily}#\``),
 			type: 'boolean',
 			tags: ['preview'],
-			'default': false
+			default: false
 		},
 		[TerminalSettingId.FontSize]: {
 			description: localize('terminal.integrated.fontSize', "Controls the font size in pixels of the terminal."),