CLion 自2022年起原生集成Markdown插件，打开.md文件即支持语法高亮与双栏实时预览（需手动触发Preview）；图片须用./开头的相对路径；格式化行为由Code Style设置控制，不影响HTML输出。
CLion 默认就支持 Markdown，不需要额外安装插件
CLion 自 2022 年起已原生集成 org.intellij.plugins.markdown 插件，只要文件后缀是 .md 或 .markdown，打开即用。你不需要去 Marketplace 搜索安装「Markdown Support」——它早已内置，且随 IDE 更新自动升级（最新版对应 MDX 251.17181.16，发布于 2026 年 6 月）。
常见误操作是手动禁用该插件（在 Settings → Plugins 中误点 Disable），导致 .md 文件失去语法高亮和预览功能。若发现 Markdown 文件变成本色纯文本，请检查该插件是否被关闭。
如何让 .md 文件正常渲染并启用实时预览
CLion 的 Markdown 编辑器默认开启双栏模式：左写源码，右看 HTML 渲染效果。但这个预览 Pane 不会自动弹出，需手动触发：
- 打开任意
.md文件后，按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）唤出命令面板，输入Preview，选中Markdown Preview - 或右键编辑区 →
Preview - 若仍不显示，检查
Settings → Languages & Frameworks → Markdown中是否勾选了Enable preview
注意：Preview 是实时的，但仅响应保存后的变更（非 typing 时即时刷新）。如需边输边看，可启用 Wrap on typing（在 Settings → Editor → Code Style → Markdown → Wrapping 中），它会让长段落自动换行，提升可读性，但不影响渲染结果。
将选定的 Obsidian 笔记发布为静态站点并部署到 Cloudflare Pages。
为什么插入图片后预览不显示？路径怎么写才对
CLion 渲染 Markdown 图片依赖的是相对路径解析规则，不是浏览器那一套。常见失效原因：
-
—— ✅ 正确：以当前.md文件为基准的相对路径 -
—— ❌ 错误：缺./，CLion 会尝试从项目根目录找，而非同级目录 -
—— ❌ 错误：绝对路径、file://协议均不被支持 - 图片放在
resources/目录但未标记为 Resources Root —— CLion 不会扫描非源码目录，建议统一放在docs/或README/下，并保持路径扁平
如果你用的是第三方图床插件（如 Markdown Image Kit），它只负责上传并替换链接，不改变本地路径逻辑。上传后生成的 https://... 链接在预览中能正常显示，但离线时失效 —— 这是设计使然，不是 bug。
自定义换行、标题空格等格式行为
CLion 的 Markdown 格式化默认较“严格”，比如它会自动删掉 # 标题 后多余的空格，也会在重排版时把段落连成一行。这些行为由 Settings → Editor → Code Style → Markdown 控制，关键选项有：
-
Hard wrap at：设为80，则编辑器内显示垂直标尺，且Reformat Code时会按此列宽折行（但不影响 HTML 渲染） -
Keep line breaks inside text blocks：勾选后，手动换行的段落不会被合并成一段 —— 对写文档很重要 -
After header symbol：控制#和文字之间是否强制一个空格（推荐开启，符合 CommonMark 规范） -
Format tables：开启后，用|写的表格会被自动对齐列宽 —— 但注意，它只在执行Reformat Code时生效，不是边打边调
这些设置改完后，Preview 窗格会立刻反映效果，无需重启 IDE。不过要注意：格式化规则只影响编辑体验，不改变最终生成的 HTML 结构 —— 它只是帮你写得更规范，不是编译器。
