FoldingText for Atom User's Guide

Import & Export

FoldingText's uses FTML as it's default file format. But it also supports working with other formats.

Outline Processor Markup Language

Outline Processor Markup Language (OPML) is a common format for outlines.

FoldingText associates with and edits .opml files. When you open a .opml file in Atom it will open in FoldingText's outline editor. When you make changes to that file FoldingText will save as OPML instead of using the default FTML format.

When you paste text into FoldingText it will detect if the pasted text is in OPML format, and if so it will read it in as an OPML outline.

Use these commands (Use Command-Shift-P to list) to import and export OPML:

  • Copy Opml Copy the current outline selection as OPML
  • Cut Opml Cut the current outline selection as OPML
  • Paste Opml Paste the clipboard contents as OPML

Plain Text

FoldingText allows you to import/export using a plain text:

  • One line of text per item
  • Indentation represented by leading tabs
  • Attributes listed after item's text using @attrname(attrvalue) convention

Inline formatting and unique ids are lost when converting to TEXT format.

Use these commands (Use Command-Shift-P to list) to import and export TEXT:

  • Copy Text Copy the current outline selection as TEXT
  • Cut Text Cut the current outline selection as TEXT
  • Paste Text Paste the clipboard contents as TEXT

Inline HTML Fragments

When you are in text mode and Command-C to copy FoldingText stores the text as an inline HTML fragment.

When you paste in text FoldingText attempts to detect and parse HTML fragments. By FoldingText's definition an HTML fragment is a single line of text that contains at least one HTML element.