感谢分析，我理解下来落到功能上就是：提供标题块转文档块的功能，将该标题块下的内容块一并移动到新的文档块中。我的理解应该没问题吧？是不是少了些什么考虑，麻烦帮我指出，谢谢！

@88250

没错，不过这个转换应该是双向的：

1. 标题块及下方内容可以转为一个文档块，标题名变为文档名，同时下方内容块里最高级的 # 标题在转换进文档里的时候应该变为一级标题（比如被转换的标题是一个二级标题，那么它下方内容块里的三级标题在转换后应该变成新文档里的一级标题）
2. 文档块也可以转换为一个标题块，文档名变为标题名，文档内部的正文变成标题下的内容块，同时每个 # 标题也要降级（比如一个文档块转换为了一个二级标题，那么原文档块里的一级标题在转换后应该变成新的二级标题下方的三级标题）

虽然说得有点啰嗦，不过这个转换应该还是很直观的。当然最重要的还是转换过程中 id 不变，以保持原来的链接有效性

类似地，可能还有其他容器块（List/Blockquote）似乎也可以考虑做和文档块的互转。标题块和文档块的互转在逻辑上是比较通顺的，因为标题正如你所说的刚好可以用作文档名（或相反），该设计非常巧妙。

我们再思考一阵子，不出意外的话这个提议会在 0.5.5~0.6.5 左右引入，谢谢。

@88250

谢谢。我认为这个问题是文档类软件比起大纲类软件最大的软肋，不过我还没给其它产品讲过。如果这个问题得以解决，我一定要公开吹爆思源。

实现可以选中一部分块拖拽移动到其他地方的功能就可以解决这个问题了

你好，目前已经基本实现完了，但是感觉有点……如果有时间，请看一下下面的内容是否清晰，将来会放在帮助文档里：

文档块和标题块的对应关系

标题块和文档块具有天然的对应关系，因为：

• 每一个文档块都有一个名称
• 每一个标题块也都有一个名称

所以我们可以在文档块和标题块之间进行相互转换。另外，因为内容块是根据 id 进行引用的，所以转换过程不会破坏已有的引用关系。

将文档块转换为标题块

在文件树上，选择需要转换为标题块的文档，然后将其拖拽到编辑器页签中需要插入的位置。这里有两种情况：

1. 将文档块放置到已有标题块上，此时文档块将作为该标题块的平级节点插入到下方
2. 将文档块放置到非标题块上，此时文档块将作为该块所属标题块的子节点插入

文档块转换为标题块后：

• 原文档名将变为标题名
• 逻辑上文档块是一级标题，会根据插入位置进行相对层级变更
• 原文档内的各标题层级会根据插入位置进行调整
  • 对于上述情况一：比如原文档内包含一、二、三级标题，插入位置是一个二级标题，则文档块转换后的标题块会是一个二级标题，原来内容中的一、二、三级标题会变为二、三、四级标题
  • 对于上述情况二：比如原文档内包含一、二、三级标题，插入位置是一个二级标题下的段落块，则文档块转换后的标题块会是一个三级标题，原来内容中的 一、二、三级标题会变为三、四、五级标题

将标题块转换为文档块

在编辑器页签中选择需要转换的标题块，按住该标题块标识图标，然后将其拖拽到文件树需要放置的文件夹中。

标题块转换为文档块后：

• 标题名将变为文档名
• 原标题块下如果有子标题，则会按照这些子标题中最大的层级作为新文档中一级标题，其余子标题会根据相对层级进行调整
  • 比如原标题块下包含了三、四、五级子标题，则转换为文档块后会将这些子标题转换为一、二、三级标题

如果感觉设计不好或者有简化的话欢迎讨论，目前的实现似乎有点用不起来的感觉 😂

小标题的升降规则看起来没有问题，不过 gif 里没看到对于引用链接的测试。

我想我大概知道你为什么会有这种感觉，有三个原因吧。

第一个原因......这个 gif 里的文字都是 foobar，没有什么实际内容，所以看不出作用。

我分享了一个 demo，可以用这里的内容试试（但是浏览器里的显示好像有点问题，引用链接没显示出来），应该会有不一样的感觉：

https://ld246.com/udanax/s/1605629299270/stage/build/desktop/

在这个 demo 里，「自然资源保护」和「汉朝」都引用了「秦朝」，「秦朝」和「汉朝」可以拖进新建的「朝代列表」里，这个实用性就比较明显了，在大纲编辑器里经常进行类似的结构重组。之后只要保证原来的引用链接不失效就好了。

第二个原因是，在大纲编辑器里，如果单独拖动某一个节点，特别是在进行距离比较远的拖动的时候，这个节点往往处于折叠状态，这样在视觉上就直观得多，不会给人一种在拖动一大坨东西的感觉。但是思源的编辑器目前还没有正文折叠功能（我一直觉得现代编辑器如果没有正文折叠功能的话实用性会大打折扣），如果在编辑器里可以按标题进行折叠，那么：

1. 把标题拖往文件树之前先折叠一下，那么在实际拖动之前就已经可以清晰看到哪些内容会被移走
2. 把文档拖进正文区域的时候，如果默认进入折叠状态，原来编辑区在视觉上展示的内容就不会被打乱，看上去仅仅增加了一行，对插入位置的展示比较清晰

第三个原因是，文档拖进正文的时候，具体会变成几级标题似乎是看插入的位置（在上面那个 gif 里，是拖到了跟原有的某个二级标题重合的位置再松手，不知道对「同级」和「子级」有没有区分），但是，比如某个文档拖入变成了一级标题，这是手滑的结果，我实际上想让它做二级标题，可这时会发现在编辑器内部反而没有调整层级的手段了，这就显得有点割裂。

一个文件夹里的所有子文件夹和文档是树状结构，一个文档内部的所有 H 标题也是树状结构，这两棵树在以前是不能互通的，但在可以通过拖动来打通了，这才是需要这个转换功能的真正原因，是有缘由的。文件树的结构调整已经没有什么新花样可言，但是在一个文档内部，树状结构的调整往往是欠缺的。在大纲编辑器里，光标选中一部分内容然后按 tab 键，它们就会集体向右缩进，文档编辑器也可以针对 H 标题定义同样的行为，落到功能上仅仅是批量增减 H 标题的井号数目。

放两个在 org-mode 里录的动图，应该比较生动地表现出了上面的全部意思：

选中一个区域然后整体调整标题层级：

折叠状态下也可以生效：

在 {文件树，转换，文档} 这三个层面，文件树的结构调整操作其实没有什么可优化的，转换功能也完成了，剩下的就只有优化文档内部的结构调整功能了。在编辑器部分进一步优化之前，转换功能目前看来没有什么问题，这个突破已经做出了，应该可以就这样先发布。

感谢反馈，我们再调整下，预计下周一发布，谢谢。

@88250

文档转换为 2 级及以上的标题时，子标题的层级有 bug：

只有在文档转为 1 级标题的时候没有问题

## 特点 应该转换为三级标题么？

## 特点 应该转换为三级标题么？

因为「汉朝」是 2 级标题的话，「特点」当然应该是 3 级标题

感谢指出，稍后调整。

v0.5.4 中进行了一些调整，估计过两天发布，谢谢。