var parse = require('commonform-markup-content-parse')

The exported function takes a string argument containing a single line of text with common form markup tags and returns a common form.

Definitions

Type the term being defined between double-double quotes:

var assert = require('assert')

assert.deepEqual(
  parse('Define terms like ""Consideration""'),
  [ 'Define terms like ', { definition: 'Consideration' } ])

Uses

To use a defined term, type it between angle brackets:

assert.deepEqual(
  parse('Use defined terms like <Consideration>'),
  [ 'Use defined terms like ', { use: 'Consideration' } ])

References

Type the target form's heading between curly brackets:

assert.deepEqual(
  parse('Reference headings like {Services}'),
  [ 'Reference headings like ', { reference: 'Services' } ])

Blanks

Write a label for a fill-in-the-blank in square brackets:

assert.deepEqual(
  parse('Leave blanks like [Company Name]'),
  [ 'Leave blanks like ', { blank: 'Company Name' } ])

All Together

assert.deepEqual(
  parse(
    [ 'Define a term ""Apple"" ',
      'then use it <Apple> ',
      'while referencing {Orange} ',
      'with a blank for [Berry]' ]
      .join('')),
  [ 'Define a term ', { definition: 'Apple' },
    ' then use it ', { use: 'Apple' },
    ' while referencing ', { reference: 'Orange' },
    ' with a blank for ', { blank: 'Berry' } ])

Finer Details

Terms, headings, and fill-in-the-blank labels cannot start or end with spaces:

assert.deepEqual(
  parse('""Consideration ""'),
  [ '""Consideration ""' ])

assert.deepEqual(
  parse('[ Company Name]'),
  [ '[ Company Name]' ])

assert.deepEqual(
  parse('< Company Name >'),
  [ '< Company Name >' ])

Characters used to write markup can be used in free text: