bob articles¶

Format and inspect article notes (frontmatter type: "[[article]]").

Every `bob articles` command reads or rewrites notes whose type is `[[article]]`. bob owns their section numbers (1. / 1.1 / 1.1.1) and layout; formatting never changes a word. Bare `bob articles` runs the read-only `list` command.

Usage: bob articles [OPTIONS]
       bob articles <COMMAND>

Commands:
  adopt    Mark a note as an article; preview unless --write
  format   Number sections and tidy layout in article notes
  list     List article notes with sections, TODO stubs, and findings
  outline  Print an article's numbered section outline
  help     Print this message or the help of the given subcommand(s)

Options:
  -b, --bob-dir <PATH>
          Bob vault root; defaults to BOB_DIR or ~/bob

  -f, --format <FORMAT>
          Output format: human or json

          [default: human]
          [possible values: human, json]

  -h, --help
          Print help (see a summary with '-h')

Examples:
  bob articles                                List article notes
  bob articles adopt sase_blog_contents       Preview adopting a note
  bob articles adopt -w sase_blog_contents    Adopt it
  bob articles format sase_blog_contents      Format one article
  bob articles format -a -c                   Exit 1 if any article needs formatting
  bob articles outline sase_blog_contents     Numbered outline with word counts

See docs/articles.md for the rules and the JSON contract.