[{"data":1,"prerenderedAt":689},["ShallowReactive",2],{"/reference/import-notes":3,"/reference/import-notes-surround":679},{"id":4,"title":5,"body":6,"description":126,"extension":671,"links":672,"meta":673,"navigation":674,"path":675,"seo":676,"stem":677,"__hash__":678},"docs/2.reference/import-notes.md","Importing notes from other apps",{"type":7,"value":8,"toc":651},"minimark",[9,17,20,27,30,35,38,43,46,50,53,94,98,113,117,120,240,243,333,337,344,356,360,363,377,380,390,394,406,411,415,422,427,431,438,449,466,469,473,476,481,484,488,540,544,547,586,590,593,635,639,647],[10,11,13],"caution",{"title":12},"Coming soon",[14,15,16],"p",{},"This feature is not yet available. We are working hard to make it available as soon as possible.",[14,18,19],{},"You can import a zip file containing notes from other apps into Capacities. The import can contain Markdown files and media files (images, PDFs, audio files, etc.).",[21,22,24],"warning",{"title":23},"❗️ Important note",[14,25,26],{},"Please read the whole guide carefully before importing your notes. The import will potentially create many new objects in your space and clutter your organization and note-taking experience. An import cannot be undone. Please make sure to understand the import rules and limitations before importing your notes.",[14,28,29],{},"Below are the general rules for importing notes into Capacities.",[31,32,34],"h2",{"id":33},"markdown-files","Markdown files",[14,36,37],{},"Your notes will be imported to the specified space. Usually they will be added as a page unless a type or rules for the import are specified (see below). The import will try to preserve the structure of your notes as much as possible.",[39,40,42],"h3",{"id":41},"formatting","Formatting",[14,44,45],{},"The import supports any common Markdown formatting options. All special cases are listed below.",[39,47,49],{"id":48},"linking","Linking",[14,51,52],{},"Links following these options will be correctly added:",[54,55,56,68,76,85],"ul",{},[57,58,59,67],"li",{},[60,61,62,63],"strong",{},"Markdown links to notes ",[64,65,66],"code",{},"[link Text](linkUrl)",": Link URLs need to point to a local file in your import (relative or absolute path) and needs to be encoded as URL (no whitespace). If the file cannot be found, the link will be ignored.",[57,69,70,67],{},[60,71,72,73],{},"Markdown links to files ",[64,74,75],{},"![link Text](linkUrl)",[57,77,78,84],{},[60,79,80,81],{},"Wikilinks ",[64,82,83],{},"[[Note title]]",": Wikilinks need to either reference a local file name or a note which is already in your space. If no note can be found, it will be ignored.",[57,86,87,93],{},[60,88,89,90],{},"Wikilinks to files ",[64,91,92],{},"![[File name]]",": Wikilinks need to reference a local file name. If no file can be found, it will be ignored.",[39,95,97],{"id":96},"in-text-tagging","In-text tagging",[14,99,100,101,104,105,108,109,112],{},"Hashtags in your import will be transformed to Capacities tags. A tag needs to start with a ",[64,102,103],{},"#"," and can contain letters, numbers, ",[64,106,107],{},"-"," and ",[64,110,111],{},"_",".",[39,114,116],{"id":115},"frontmatter","Frontmatter",[14,118,119],{},"Frontmatter is a YAML block at the top of your note. It can contain metadata about your note. Capacities will import all properties of your frontmatter as properties to your object.",[121,122,127],"pre",{"className":123,"code":124,"language":125,"meta":126,"style":126},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","---\ntype: Book\ntitle: Antifragile\ndescription: A book about things that gain from disorder\ncreatedAt: 2012-11-27 12:23\ntags:\n  - book\n  - non-fiction\nAuthor: Nassim Nicholas Taleb\nRating: 8\n---\n","yaml","",[64,128,129,138,153,164,175,186,195,204,212,223,235],{"__ignoreMap":126},[130,131,134],"span",{"class":132,"line":133},"line",1,[130,135,137],{"class":136},"sBMFI","---\n",[130,139,141,145,149],{"class":132,"line":140},2,[130,142,144],{"class":143},"swJcz","type",[130,146,148],{"class":147},"sMK4o",":",[130,150,152],{"class":151},"sfazB"," Book\n",[130,154,156,159,161],{"class":132,"line":155},3,[130,157,158],{"class":143},"title",[130,160,148],{"class":147},[130,162,163],{"class":151}," Antifragile\n",[130,165,167,170,172],{"class":132,"line":166},4,[130,168,169],{"class":143},"description",[130,171,148],{"class":147},[130,173,174],{"class":151}," A book about things that gain from disorder\n",[130,176,178,181,183],{"class":132,"line":177},5,[130,179,180],{"class":143},"createdAt",[130,182,148],{"class":147},[130,184,185],{"class":151}," 2012-11-27 12:23\n",[130,187,189,192],{"class":132,"line":188},6,[130,190,191],{"class":143},"tags",[130,193,194],{"class":147},":\n",[130,196,198,201],{"class":132,"line":197},7,[130,199,200],{"class":147},"  -",[130,202,203],{"class":151}," book\n",[130,205,207,209],{"class":132,"line":206},8,[130,208,200],{"class":147},[130,210,211],{"class":151}," non-fiction\n",[130,213,215,218,220],{"class":132,"line":214},9,[130,216,217],{"class":143},"Author",[130,219,148],{"class":147},[130,221,222],{"class":151}," Nassim Nicholas Taleb\n",[130,224,226,229,231],{"class":132,"line":225},10,[130,227,228],{"class":143},"Rating",[130,230,148],{"class":147},[130,232,234],{"class":233},"sbssI"," 8\n",[130,236,238],{"class":132,"line":237},11,[130,239,137],{"class":136},[14,241,242],{},"Certain properties have a special purpose. They need to be named exactly as specified below:",[54,244,245,258,265,272,294,305],{},[57,246,247,251,252],{},[60,248,249],{},[64,250,144],{},": The type of your object. The type needs to be exactly the singular of the object type in your space. If no type is specified or the type cannot be found in your space, the object will be imported as a page.",[253,254,255],"tip",{},[14,256,257],{},"If you want to import your notes into a object based structure we recommend to first create and structure your objects in Capacities and then import your notes.",[57,259,260,264],{},[60,261,262],{},[64,263,158],{},": The title of your object. If no title is specified, the title will be the file name of your note.",[57,266,267,271],{},[60,268,269],{},[64,270,169],{},": The description of your object. If no description is specified, the description will be empty.",[57,273,274,278,279,282,283,290,291,112],{},[60,275,276],{},[64,277,180],{},": The creation date of your object. If no creation date is specified, the creation date will be the date of the import. The date needs to be in the format ",[64,280,281],{},"YYYY-MM-DD HH:mm"," or as an ISO 8601 string (more information ",[284,285,289],"a",{"href":286,"rel":287},"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date#date_time_string_format",[288],"nofollow","here",") ",[60,292,293],{},"at GMT+0, not your local time zone",[57,295,296,300,301,304],{},[60,297,298],{},[64,299,191],{},": The tags of your object. If no tags are specified, the tags will be empty. Tags need to either be comma separated or in a yaml list (either ",[64,302,303],{},"[tag1, tag2]"," or with dashed like above).",[57,306,307,310,311,314,315,318,319],{},[60,308,309],{},"Other properties",": All other properties will be added to your object as properties. The property name needs to be exactly the same as the property name of your object or a lowerCamelCase version of it (e.g. ",[64,312,313],{},"Author of Book"," can be imported from ",[64,316,317],{},"authorOfBook","). If the property does not exist, it will be added as unstructured metadata to your object and will be visible on the object page. The import currently accepts the following types of properties:",[54,320,321,327],{},[57,322,323,326],{},[60,324,325],{},"Text",": Text properties will be imported as text. The text should not contain any line breaks or formatting.",[57,328,329,332],{},[60,330,331],{},"Number",": Number properties will be imported as numbers. The number should not contain any formatting.",[31,334,336],{"id":335},"files-and-media","Files and media",[14,338,339,340,343],{},"All other files will be analyzed and uploaded to Capacities as images, PDFs, audio files, or files. The file type will be determined based on the file extension. If the file type cannot be determined, it will be ignored. Files can be referenced in your notes using Markdown links or Wikilinks (see ",[284,341,48],{"href":342},"#linking",").",[345,346,347],"note",{},[14,348,349,350,355],{},"There are limits to the number and size of files you can upload to Capacities. Please check the ",[284,351,354],{"href":352,"rel":353},"https://capacities.io/pricing",[288],"pricing page"," for more information.",[31,357,359],{"id":358},"csv-files","CSV files",[14,361,362],{},"CSV files allow you to import structured data to Capacities. The import will try to preserve the structure of your data as much as possible. You can import CSV files in two ways:",[54,364,365,371],{},[57,366,367,370],{},[60,368,369],{},"As a file object",": CSV files will be imported as a file object. The file will be uploaded to Capacities and can be referenced in your notes.",[57,372,373,376],{},[60,374,375],{},"As a collection",": CSV files will be transformed into collections in Capacities. Each row in your CSV file will become an object of a certain type in your space. To properly map the object type and properties, please make sure to follow the rules below.",[14,378,379],{},"In the following, you can read more about import rules for importing CSV files as collections.",[21,381,383],{"title":382},"Delimiter",[14,384,385,386,389],{},"The import currently only supports CSV files with a semicolon ",[64,387,388],{},";"," as a delimiter. If your CSV file uses a different delimiter, please convert your file to a semicolon-separated CSV file before importing.",[39,391,393],{"id":392},"csv-object-type-and-collection-name","CSV object type and collection name",[14,395,396,397,401,402,405],{},"Capacities will determine the object type of your CSV rows based on the ",[284,398,400],{"href":399},"#object-type-settings","object type settings"," in the import settings. The type of your objects will be your fallback object type unless you select ",[60,403,404],{},"Top-level folder as object type",". In that case the type of your collection will be determined based on the name of your top-level folder (read more below). If you import multiple CSV files, make sure to name them differently to avoid conflicts.",[253,407,408],{},[14,409,410],{},"This option allows you to conveniently import structured content to Capacities. Simply create folders named after the plural of your object type and add your CSV files to these folders. Every CSV file will become a collection of that object type.",[39,412,414],{"id":413},"csv-property-mapping","CSV property mapping",[14,416,417,418,112],{},"The import will try to map the columns of your CSV file to the properties of your object type. If the property does not exist, it will be added as unstructured metadata to your object and will be visible on the object page. The matching will work exactly like the matching rules of ",[284,419,421],{"href":420},"#frontmatter","frontmatter properties in Markdown files",[10,423,424],{},[14,425,426],{},"Every CSV file needs to have a header row. The header row will be used to determine the property names of your object type. If the header row is missing, properties cannot be matched and the import will not work properly.",[39,428,430],{"id":429},"mapping-csv-rows-to-markdown-files","Mapping CSV rows to markdown files",[14,432,433,434,437],{},"If you want to import your CSV file as additional metadata to your markdown files, your CSV file needs to contain a column with the name ",[64,435,436],{},"reference",". The reference column needs to be an absolute path to your markdown file. The import will try to match the reference column to the file name of your markdown files. If the reference column does not exist or the markdown file cannot be found, a new object based on your CSV row will be created.",[14,439,440,441,444,445,448],{},"If you for example have a top-level folder called ",[64,442,443],{},"Meetings"," with a Markdown file called ",[64,446,447],{},"Meeting1.md"," your CSV file should look something like this:",[121,450,454],{"className":451,"code":452,"language":453,"meta":126,"style":126},"language-csv shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","title; tags; reference\nMeeting1; project-unicorn; Meetings/Meeting1.md\n","csv",[64,455,456,461],{"__ignoreMap":126},[130,457,458],{"class":132,"line":133},[130,459,460],{},"title; tags; reference\n",[130,462,463],{"class":132,"line":140},[130,464,465],{},"Meeting1; project-unicorn; Meetings/Meeting1.md\n",[14,467,468],{},"If your markdown file has the same property names in the frontmatter, the import will favor the CSV data over the frontmatter data.",[31,470,472],{"id":471},"organization-options","Organization options",[14,474,475],{},"Based on how you organized your content in your import you can pick from different options to organize your import in your space.",[21,477,478],{},[14,479,480],{},"Please be aware that the import will create a lot of new objects in your space. Please make sure to understand the import rules and limitations before importing your notes. An import cannot be undone.",[14,482,483],{},"When importing notes, Capacities will try to organize your notes based on the following options:",[39,485,487],{"id":486},"object-type-settings","Object type settings",[54,489,490,502],{},[57,491,492,495,498,499,501],{},[60,493,494],{},"Fallback object type",[496,497],"br",{},"Notes will get converted to objects based on the ",[64,500,144],{}," property in the frontmatter. If you did not specify a type property, you can select a type for these notes. The default fallback object type is Page.",[57,503,504,506,508,509,512,513,516,517,520,521,524,525,528,529,112,531],{},[60,505,404],{},[496,507],{},"If you choose these options the name of the first level folder will be used as a type identifier. It's important to use the plural of your object type. If you for example have an object called ",[64,510,511],{},"Meeting Note"," (Plural of name: ",[64,514,515],{},"Meeting Notes",") the top-level folder needs to be called ",[64,518,519],{},"Meeting notes",". Higher-level folders will be ignored. If you have a nested folder, like ",[64,522,523],{},"My Notes/Meeting Notes"," the import will try to match to ",[64,526,527],{},"My Notes"," and not ",[64,530,515],{},[253,532,533],{},[14,534,535,536,539],{},"This option allows to conveniently import notes to your existing objects. Simple create top-level folders and move all your book notes in the ",[64,537,538],{},"Books"," folder, etc. If you are importing to a new space or you want to add new object types from your imported notes, simply define these objects in your space first, create a folder named after the plural of that object type and add all notes to that folder.",[39,541,543],{"id":542},"folder-settings","Folder settings",[14,545,546],{},"My were maybe relying on a folder structure in your previous note-taking tool. Capacities does not have folders but there are multiple options on how you can import that information.",[54,548,549,557,572],{},[57,550,551,554,556],{},[60,552,553],{},"Ignore Folders",[496,555],{},"All notes will be imported but the folder structure will be lost.",[57,558,559,562,564,565,568,569,112],{},[60,560,561],{},"Add to top of content",[496,563],{},"All notes will be imported and and the name of the folder will be added as a small note to the top of the content. If your notes was in the folder ",[64,566,567],{},"2024/Favorites"," the note will start with ",[64,570,571],{},"Folder: 2024/Favorites",[57,573,574,577,579,580,582,583,585],{},[60,575,576],{},"Add as tag",[496,578],{},"All notes will be imported and the name of the folder will be added as a tag to the note. If your notes was in the folder ",[64,581,567],{}," the note will have the tag ",[64,584,567],{},". If the tag does not exist yet, it will be created.",[39,587,589],{"id":588},"import-job-settings","Import job settings",[14,591,592],{},"If you're importing a multiple times, your you want all your imported notes to be labeled, you might loose the overview. Here are some options to keep track of your imports.",[54,594,595,603,611,623],{},[57,596,597,600,602],{},[60,598,599],{},"Do nothing",[496,601],{},"The import will be added without any additional information.",[57,604,605,608,610],{},[60,606,607],{},"Add quick note to top of content",[496,609],{},"You can choose a short text that will be added to the top of all imported notes. This can be useful to add a note like \"Imported from Obsidian\" to all your notes.",[57,612,613,616,618,619,622],{},[60,614,615],{},"Add tag to all imported notes",[496,617],{},"You can choose a tag that will be added to all imported notes. This can be useful to add a tag like ",[64,620,621],{},"Needs processing"," to all your notes.",[57,624,625,628,630,631,634],{},[60,626,627],{},"Add to collection",[496,629],{},"You can specify a collection name all imported notes will be added to. You can for example add all imported notes to a collection called ",[64,632,633],{},"Imported notes",". Please be aware, that there will be one collection created for every object type you import notes to.",[31,636,638],{"id":637},"limitations","Limitations",[54,640,641,644],{},[57,642,643],{},"Folder structures",[57,645,646],{},"Entity properties if note does not exist",[648,649,650],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":126,"searchDepth":133,"depth":140,"links":652},[653,659,660,665,670],{"id":33,"depth":140,"text":34,"children":654},[655,656,657,658],{"id":41,"depth":155,"text":42},{"id":48,"depth":155,"text":49},{"id":96,"depth":155,"text":97},{"id":115,"depth":155,"text":116},{"id":335,"depth":140,"text":336},{"id":358,"depth":140,"text":359,"children":661},[662,663,664],{"id":392,"depth":155,"text":393},{"id":413,"depth":155,"text":414},{"id":429,"depth":155,"text":430},{"id":471,"depth":140,"text":472,"children":666},[667,668,669],{"id":486,"depth":155,"text":487},{"id":542,"depth":155,"text":543},{"id":588,"depth":155,"text":589},{"id":637,"depth":140,"text":638},"md",null,{},true,"/reference/import-notes",{"title":5,"description":126},"2.reference/import-notes","cw8P9VWvob2agwhtWeLUgnNV9zmQjBrW-Fc_Fa25mAw",[680,684],{"title":681,"path":682,"stem":683,"children":-1},"Import content to Capacities","/reference/import","2.reference/import",{"title":685,"path":686,"stem":687,"icon":688,"children":-1},"Integrations","/reference/integrations","2.reference/integrations/index","i-ph-puzzle-piece",1775120824262]