FAQ and Troubleshooting

Feature catalog: Features.

Do I need a special file extension?

No. Documents are plain .md only.

Does installing ODS auto-make my Markdown compliant?

No. Without root ods:, tools do not rewrite your tree. Plain Markdown is Level 0.

• Opt in: ods init . or ods init . --adopt, then ods lint.
• Opt out: ods disable . then ods disable . --write.
• Automation (ods start / ods watch) only rewrites paths when the workspace is enabled.

How do I remove ODS completely?

ods stop --unregister .   # if a service was registered
ods disable . --write

Profile vs Tags

Should depends / related include .md?

Yes. Canonical Document references use editor-jumpable .md paths:

depends:
  - website/subscription-service.md

ods lint says everything is fine

That is success: the graph and links are consistent. No ods-error.md should remain.

How much RAM does ods serve use?

Local measurements on macOS:

• Empty ODS workspace: ~7.5 MB
• 1000-document workspace: ~17 MB

For low-memory environments, use polling mode:

ODS_LOW_MEMORY=1 ods serve --mode poll --memory-report --poll-secs 30 --root .