VSCode内置了Markdown文件的预览功能,但是默认的设置存在一些影响阅读体验的问题:

  1. 引用(blockquote)样式问题

    • 默认的引用块底色过深(通常是深灰色背景)
    • 文字与边框的间距不够合理
    • 在深色主题下尤为明显,容易造成视觉疲劳
  2. 代码块显示问题

    • 长行代码不会自动换行,导致出现横向滚动条
    • 影响代码阅读体验,特别是查看长字符串时
    • 需要手动左右滚动才能查看完整内容

解决方法如下:

一、修改引用样式

  1. 打开VSCode设置(快捷键:Ctrl+Shift+P)
  2. 搜索">Markdown Preview Enhanced: Customize CSS (Global)",直接修改全局的配置,接下来打开一个style.less文件(C:\Users\用户名\.crossnote\style.less)
  3. 添加自定义CSS样式
  blockquote {
    background-color: #f6f8fa; /* 调浅这里 */
    border-left: 4px solid #ccc;
    color: #666;
    padding: 0.5em 1em;
  }

二、解决代码块换行问题

添加以下配置:

  pre,code {
    white-space: pre-wrap;  /* 自动换行 */
    word-break: break-all;  /* 长单词/链接强制断行 */
  }

三、全部代码

style.less文件(C:\Users\用户名\.crossnote\style.less)全部配置如下

.markdown-preview.markdown-preview {
  blockquote {
    background-color: #f6f8fa;  /* 调浅这里 */
    border-left: 4px solid #ccc;
    color: #666;
    padding: 0.5em 1em;
  }

  pre,code {
    white-space: pre-wrap;  /* 自动换行 */
    word-break: break-all;  /* 长单词/链接强制断行 */
  }
}

四、应用场景举例:

  • 技术文档编写时,长命令行更易阅读
  • 代码注释中的示例能完整显示
  • 引用文献时视觉更舒适

这些修改可以显著提升Markdown写作和预览体验。修改后立刻生效。

更多推荐