java后端存markdown应原样保存字符串至mediumtext/longtext字段，api返回前实时渲染；多对多关联用显式三表设计；读多写少场景优先mybatis；统一gfm子集并校验输入输出。
Java后端怎么存Markdown文章并保留原始格式
直接用String存没问题，但别用TEXT字段在MySQL里乱设长度——很多ORM默认映射String到VARCHAR(255)，一存长文就截断。实际要用MEDIUMTEXT或LONGTEXT，并在JPA实体里显式加@Column(columnDefinition = "MEDIUMTEXT")。
别把渲染逻辑塞进存储层：有人图省事，在save()前用CommonMark转成HTML再存，结果想改样式或换解析器时全得重导数据。正确做法是原样存Markdown字符串，只在API返回前调用HtmlRenderer实时渲染。
- 前端传来的
content字段，后端不做任何清洗（比如删<script></script>），交由前端XSS防护处理 - 如果需支持图片上传，Markdown里用相对路径如
，后端提供/uploads/**静态资源路由 - Git风格的front matter（如
---\ntitle: xxx\n---）建议拆出来单独存字段，别混在content里解析
Spring Boot里怎么实现文章和分类/标签的多对多关联查询
别手写@ManyToMany然后靠JPA自动生成中间表——它生成的表名和字段名不可控，查分类下所有文章时容易因懒加载触发N+1，而且标签过滤这种“文章 ∈ 分类A AND 文章 ∈ 标签B”的组合查询根本没法用JPQL优雅表达。
老实用三张表：article、category、tag，外加article_category和article_tag两个关联表。JPA里用@JoinTable手动指定，避免Hibernate瞎猜。
立即学习“Java免费学习笔记（深入）”；
- 查某分类下的文章列表：用
@Query写原生SQL，JOIN article_category ON article.id = article_category.article_id，别依赖category.getArticles() - 同时按分类和标签筛选：WHERE子句里嵌套
EXISTS (SELECT 1 FROM article_tag WHERE ...)，比多次IN更稳 - 标签云统计（每个标签的文章数）：直接
GROUP BY tag.name，别在Java里循环计数
为什么用MyBatis比JPA更适合博客这类读多写少场景
博客接口90%是查：首页列表、分类页、详情页、标签页。JPA的二级缓存难配，@Query写复杂SQL又丢掉类型安全；而MyBatis的<foreach></foreach>和<choose></choose>能干净地拼接动态条件，Mapper XML里还能直接写SELECT SQL_CALC_FOUND_ROWS做分页总数。
不是说JPA不行，而是当你需要ORDER BY CASE WHEN tag.name = 'Java' THEN 0 ELSE 1 END这种排序，或者给不同终端返回不同字段集（管理后台要raw_content，前端只要html_content），MyBatis写起来不拧巴。
- 用
@SelectProvider配合StringBuilder拼SQL，比一堆@Query注解更易维护 - DTO和Entity严格分离，
ArticleVO里只放API需要的字段，避免JPA代理对象泄漏或LazyInitializationException - 分页别用
PageHelper——它依赖ThreadLocal，异步线程里会丢偏移量；改用MyBatis-Plus的Page<articlevo></articlevo>+IPage接口
前后端联调时Markdown渲染结果不一致的常见原因
后端用commonmark-java 0.22.0，前端用marked 4.x，两者对缩进代码块、表格对齐、脚注的解析规则不同。最典型的是 code（4空格）在后端被当普通段落，在前端却渲染成<pre class="brush:php;toolbar:false;"></pre>。
解决思路不是强行统一库版本（前端升级可能破UI），而是约定“只用GitHub Flavored Markdown子集”，并在文档里明确禁用功能：比如禁用脚注、禁用数学公式、表格必须有表头。
- 后端API返回加一个
rendered_at时间戳，前端可据此判断内容是否已渲染过，避免重复转换 - 富文本编辑器（如Tiptap）提交前，用
remark-gfm预处理一次，保证输入格式可控 - 本地开发时，用
curl -H "Accept: application/json" http://localhost:8080/api/articles/1直看原始JSON响应，别只信浏览器插件渲染效果
真实项目里，最难的不是存Markdown或连标签，而是让运营同学粘贴的Word文档里的换行、全角空格、中文标点，在前后端之间不悄悄变形。这事没银弹，只能靠输入校验+输出快照+定期diff。
