2026-05-01
Obsidian Longform 插件：长篇文稿写作完整指南
掌握 Obsidian 的 Longform 插件。在这份 2026 年的完整指南中，学习如何无缝地组织场景、管理草稿并编译你的手稿。
编辑摘要
我发现 Longform 插件通过将单个 Markdown 文件视为可以在拖拽式侧边栏中排列的模块化场景，将 Obsidian 变成了一个强大的长篇文稿编辑器。该插件的非破坏性方法——将顺序数据单独存储，同时保持你的库（vault）原样不动——吸引了那些看重纯文本便携性而非专有格式的作家。然而，复杂的导出过程确实是一个妥协：Scrivener 可以直接编译为多种格式，而 Longform 需要像 Pandoc 这样的第三方工具来输出 Word 或 PDF。使用平行的文件夹系统将手稿文件与研究笔记分开，对于防止意外编译辅助材料至关重要。
Obsidian Longform 插件：长篇文稿写作完整指南
快速解答： Longform 插件将 Obsidian 从一个标准的笔记环境改造为类似于 Scrivener 的结构化手稿编辑器。它允许作家将各个 Markdown 文件组织成有序的场景和章节，通过拖拽式侧边栏进行排列，并将它们编译成单一连贯的手稿文件，而无需改变核心 vault 的层级结构。
在标准的 Markdown 应用程序中撰写书籍、论文或长篇随笔，往往会退化成一个杂乱无章、装满零散文本文件的文件夹。虽然像 Scrivener 或 Ulysses 这样专门的写作软件能够完美处理复杂的文档结构，但许多作家更青睐 Obsidian 的隐私性、速度以及双向链接功能。当你试图将 80 个不同的场景文件排序成一个线性的叙事结构时，摩擦就产生了。
Longform 插件填补了这一空白。它在你现有的 Markdown 文件之上提供了一个非破坏性的结构层，让你能够直接在个人知识管理系统中对大型写作项目进行排序、起草和编译。
通过将单个笔记视为模块化的场景，Longform 赋予了你在叙事框架内移动各个片段的灵活性，而无需进行繁琐的复制粘贴。本指南将详细介绍如何配置该插件、构建你的 vault，以及如何利用高级工作流在 Obsidian 中管理复杂的手稿写作。
Longform 插件的核心概念
要有效使用 Longform，你必须了解它如何与 Obsidian 的文件系统交互。不同于那些将你的写作锁定在专有数据库中的软件，Longform 使用的是标准的 .md 文件。
该插件基于“Projects（项目）”的概念运行。一个 Longform 项目简而言之就是你的 Obsidian vault 中一个指定的文件夹。在这个文件夹内，Longform 会追踪一组特定的笔记——你的场景或小节——并记住你排列它们的顺序。这个序列被存储在一个隐藏的 .obsidian/[plugins](/zh-cn/posts/periodic-notes-plugin-weekly-reviews/)/longform/data.json 文件中（或者根据你的版本存储在一个本地化的索引文件中），这意味着你的实际文件保持原样，不受任何影响。
你可以在移动设备上打开一个场景文件并进行编辑，这些更改会完美地反映在你桌面端 Longform 项目结构中。
为你的第一部手稿设置 Longform
初始化一个项目需要精心设计文件夹结构。创建一个专属空间可以防止你的手稿文件与日常日记或未链接的参考笔记混杂在一起。
安装与工作区配置
你可以直接从 Obsidian 的 Community Plugins（社区插件）目录中安装 Longform。搜索 “Longform”（开发者为 Kevin Kelly）并启用它。
启用后，左侧边栏会出现一个新图标，看起来像一叠纸。点击它将打开 Longform 面板，这是你手稿的控制中心。为了获得最佳的写作体验，将 Longform 面板拖动到左侧边栏，与标准的 File Explorer（文件资源管理器）并排，并保持右侧边栏打开，用于查看大纲或链接的研究笔记。
创建新项目
- 在你的 Obsidian vault 中创建一个空文件夹。给它起一个具有辨识度的名字，例如
Manuscript - The Silent Orbit。 - 打开 Longform 侧边栏面板。
- 点击 Create Project 并选择你刚刚创建的文件夹。
- Longform 会提示你设置一个索引文件。这是一个可选文件，你可以在其中存储项目元数据、大纲或概要。
一旦项目激活，你通过 Longform 侧边栏创建的任何笔记都将自动填充到该指定文件夹中。
构建场景与章节
Longform 插件的强大之处在于它的拖拽界面。在标准的 Obsidian 文件夹中，笔记是按字母顺序或创建日期排序的。而在 Longform 中，它们是按叙事逻辑排序的。
模块化写作工作流
在撰写长篇手稿时，避免将所有内容写在一个庞大的单一文件中。相反，将你的写作分解为最小的逻辑单元。对于小说来说，这通常是一个单一的场景。对于非虚构作品，这可能是一个小节或一个具体的论点。
为每个单元创建一个新笔记。在 Longform 侧边栏内，你可以上下拖动这些笔记来改变它们的顺序。如果你发现第四章的内容需要发生在第二章之前，只需将第四章的场景集群拖到列表更高的位置即可。
使用文件夹作为章节
Longform 支持在你的项目目录中使用文件夹，并将它们视为组织分隔符或 Chapters（章节）。你可以将场景文件拖入这些文件夹中进行分组。到了编译手稿的时候，Longform 可以选择性地根据这些文件夹名称插入章节标题。
这种模块化对编辑工作至关重要。它允许你隔离出一个 1500 字的场景，并完全专注于它的节奏，而不会被周围的 8 万字所干扰。
草稿与版本控制
写作离不开修改。在修改手稿时，最大的焦虑莫过于丢失某个场景的早期版本。Longform 专门针对这个问题内置了 snapshot（快照）功能。
管理项目草稿
在进行重大的结构性编辑（例如彻底删掉一个角色或改变某章的视角）之前，你可以为整个 Longform 项目建立一个快照。这会捕捉下那个时刻项目中所有文件的确切状态、顺序和内容。
如果修改失败，你可以将项目恢复到之前的草稿状态。这相当于一个局部的版本控制系统，比 Git 更简单，并且专为文字创作者设计。
场景级别的历史记录
如果你只在修改单个场景，你可以依赖 Obsidian 原生的 File Recovery 核心插件，它能与 Longform 完美配合。确保将 File Recovery 设置为每 5 分钟保存一次快照，并保留至少 30 天，以保护你的每日写作成果。
实用建议：为 Longform 构建你的 vault 结构
将一部 9 万字的手稿整合进一个同时包含杂货清单和会议记录的 vault 中，需要严格的界限。
平行文件夹系统
不要将你的研究资料、角色设定或世界观设定集存放在 Longform 项目文件夹内。如果你这样做，Longform 会试图将它们编译进你的最终手稿中。
相反，应使用平行的文件夹结构：
01 - Active Projects/The Silent Orbit/Manuscript/(这是你的 Longform 项目文件夹)01 - Chapter One/Scene 1.mdScene 2.md
Research/(放在 Longform 之外)Orbital Mechanics.md
Characters/(放在 Longform 之外)Protagonist Profile.md
这种结构让所有相关的材料在 File Explorer 中靠得很近，但又独立于 Longform 编译器。随后，你可以使用 Obsidian 的 [[wikilinks]] 从手稿场景直接链接到角色档案。
元数据与状态追踪
在单个场景文件中使用 YAML frontmatter 来追踪进度。一个标准的 Longform 场景模板可能如下所示：
---
status: first-draft
pov: Sarah
location: Main Deck
wordcount: 1250
---虽然 Longform 负责管理顺序，但你可以使用 Dataview 插件来查询这些元数据。你可以在手稿文件夹之外创建一个仪表板笔记，使用 Dataview 列出所有 status: first-draft 的场景，从而为你下一步需要编辑的内容提供清晰的路线图。
编译与导出你的作品
长篇写作的最后一步是将文本从 Obsidian 中导出，并转换为适合编辑、试读者或自出版平台使用的格式。
编译过程
当你在 Longform 侧边栏中点击 Compile 按钮时，该插件会将你项目中所有的独立 Markdown 文件拼接成一个连续的单一文件。
Longform 提供了几种编译设置：
- Scene Separators（场景分隔符）： 你可以定义一串特定的字符（如
***或#）自动插入到各个文件之间。 - Frontmatter Handling（Frontmatter 处理）： 你可以选择在编译期间剥离各个场景的 YAML frontmatter，确保你的最终文档不包含那些私密的追踪标签。
- Chapter Headings（章节标题）： 如果你将场景分组到文件夹中，Longform 可以自动基于这些文件夹的名称生成 Markdown 标题（例如
## Chapter One）。
最终输出格式化
编译过程会生成一个庞大的单一 .md 文件。由于正规出版商通常要求 .docx 或 PDF 格式，你需要转换这个编译后的文件。
为此，最可靠的工作流依赖于 Obsidian Pandoc 插件。一旦 Longform 生成了编译后的 Markdown 手稿，打开该文件，并使用 Pandoc 插件的命令将其导出为 Word（.docx）、ePub 或标准的 PDF。这条流水线让你完全在纯文本环境中进行写作，直观地安排顺序，并最终输出一份排版专业、可供提交的文档。
Longform 与传统写作软件的比较
转向 Obsidian 的作家经常将它与 Scrivener 进行比较。虽然 Longform 复制了 Scrivener 最关键的功能（活页夹/模块化写作方法），但它们在作用域上有所不同。
Longform 的优势：
- 纯文本便携性： 你的文件仅仅是 Markdown。如果 Obsidian 明天不复存在，你的手稿在任何文本编辑器中依然完全可读。而 Scrivener 的
.scriv文件则是复杂的数据库包。 - 插件生态系统： 你可以将 Longform 与其他插件结合使用，例如使用 Proximity 查找过度使用的词汇，使用 LanguageTool 进行语法检查，或使用 Dataview 进行项目跟踪。
- 成本： Obsidian 和 Longform 对个人使用是免费的。
Longform 的妥协：
- 导出复杂性： Scrivener 的编译器极其强大，允许你同时为 Kindle、打印和精装本进行格式化。而 Longform 只能编译为 Markdown；你必须依赖像 Pandoc 这样的第三方工具来进行高级排版。
- 分屏限制： Scrivener 允许你在高度定制的 corkboard（软木板）视图中查看同一手稿的多个部分。Obsidian 的 canvas（白板）和拆分窗格非常出色，但需要更多手动配置才能模仿 Scrivener 原生的布局。
综合手稿工作流
Longform 插件有效地消除了在 Obsidian 中进行长篇内容创作的主要障碍。通过在 Markdown 文件目录之上提供一个稳定的、拖拽式的结构层，它允许作家专注于单个场景，而不会迷失在宏大的叙事弧线中。
搭配严格的文件夹结构、元数据追踪以及通过 Pandoc 简化的导出流程，Longform 将 Obsidian 从一个个人知识数据库提升为一个起草复杂手稿、论文和书籍的专业级环境。
常见问题解答
我可以使用 Longform 进行学术写作和论文组织吗？
是的。Longform 非常适合学术写作。你可以为特定章节、引言、方法论和结论分配专门的文件夹，同时将独立的论点作为离散的 Markdown 文件保留。
Longform 插件会改变我原始的 Obsidian Markdown 文件吗？
不会。Longform 不会更改你原始文件的内容。它通过读取文件并将结构顺序存储在你的 vault 插件目录内一个独立的、隐藏的 JSON 文件中来管理排序。
如何将我的 Longform 项目导出为 Word 或 PDF？
首先，使用 Longform 内的编译功能将你的独立场景合并为一个大型 Markdown 文档。然后，使用像 Obsidian Pandoc 这样的社区插件，或者在 Typora 等外部 Markdown 编辑器中打开编译后的 Markdown 文件，将其导出为 DOCX 或 PDF。
Longform 兼容 Obsidian Sync 吗？
兼容。因为 Longform 将其项目顺序数据保存在 .obsidian/plugins/longform/ 目录中，只要你将 Obsidian Sync 配置为同步插件设置和数据文件，你的项目结构就会在桌面端和移动设备之间无缝同步。
我可以在 Longform 插件内跟踪我的每日写作目标吗？
Longform 提供单个场景和整个项目的基本字数统计，但它没有内置的每日目标跟踪功能。对于每日写作进度跟踪，你应该将它与 Obsidian Word Sprint 插件或 Better Word Count 插件结合使用。