#TodayILearned that #macOS#Spotlight will not index #iCloud Drive documents unless they are fully downloaded—unless you are searching for keywords stored in their extended attributes.
This is a surprisingly big oversight. The more you use #iCloudDrive to store your documents (which Apple somewhat encourages you to do), the more likely you won’t be able to find them by searching for their content with Spotlight.