悠悠楠杉
怎样在VSCode中编写Markdown?实时预览配置,vscode怎么写markdown
基础环境配置
首先确保你已安装最新版VSCode。安装完成后,我们需要进行一些基础设置:
- 打开设置(快捷键Ctrl+,)
json
// settings.json中的相关配置
{
"markdown.preview.style": "github",
"markdown.tableFormatter": "markdown-table-formatter"
}
必备插件推荐
-
- 提供自动补全、目录生成、快捷键等全方位支持
- 远超原生预览的高级预览功能
- Markdown语法检查和风格规范
- Code Spell Checker - 英文拼写检查(对技术写作特别重要)
安装方法:点击左侧活动栏扩展图标,搜索插件名称并安装。
实时预览配置详解
实时预览是高效写作的关键,以下是配置完美预览体验的步骤:
- 右键点击编辑器,选择"Open Preview to the Side"(或使用快捷键Ctrl+K V)
- 预览窗口会固定在右侧,随着编辑实时更新
高级技巧:在settings.json中添加以下配置,让预览自动滚动与编辑位置同步:
json
{
"markdown.preview.scrollPreviewWithEditor": true,
"markdown.preview.scrollEditorWithPreview": true
}
高效写作技巧
快捷键精通:
- Ctrl+B:加粗选中文字
- Ctrl+I:斜体选中文字
- Alt+C:勾选/取消任务列表项
- Ctrl+Shift+]:提升标题级别
- Ctrl+Shift+[:降低标题级别
表格处理技巧:
使用Markdown Table Formatter插件,编辑完表格后按Alt+Shift+F自动对齐表格格式。图片管理:
配置Paste Image插件,设置图片保存路径和插入格式:
json
{
"pasteImage.path": "${currentFileDir}/images",
"pasteImage.insertPattern": ""
}
个性化主题配置
长时间写作需要舒适的视觉环境,推荐配置:
- 安装One Dark Pro或GitHub Theme主题
- 设置合适的字体(推荐JetBrains Mono或Fira Code)
- 调整行高和段落间距:
json
{
"editor.fontFamily": "JetBrains Mono, Consolas, monospace",
"editor.lineHeight": 28,
"editor.fontSize": 14
}
版本控制整合
- 初始化仓库(Ctrl+Shift+G)
- 使用源代码管理面板提交更改
- 安装GitLens插件获得更强大的版本控制功能
文档导出选项
- 安装Pandoc实现更丰富的格式转换
常见问题解决
中文换行问题:
在settings.json中添加:
json { "files.eol": "\n", "markdown.preview.breaks": true }
数学公式渲染:
安装Markdown+Math插件,并启用Katex支持。特殊字符冲突:
使用Markdown Escape插件自动转义特殊字符。
我的写作工作流分享
最后分享我的实际写作流程:
- 使用Zettelkasten方法组织文档结构
- 先写大纲,用[TOC]生成目录
- 分段写作,每个段落控制在3-5行
- 使用添加写作备注
- 最终导出前用Grammarly检查语法