Docs › Load from file › Markdown & plain text
Load from file

Markdown & plain text

Import a .md or .txt file — headings are automatically turned into guide sections.

01
Open the file importer
Start from the New guide panel.

From the Sessions dashboard, click + New guide in the left sidebar. In the creation panel, select Load from file, then choose Markdown / Plain text.

02
Upload your file
Supports .md and .txt files up to 1MB.

Drag and drop your file onto the upload area, or click Browse to select it. Both .md (Markdown) and .txt (plain text) files are supported.

Screenshot: File upload panel Drop image at /images/docs/md-upload.png
03
How sections are created
Headings become section titles — body text becomes content.

Pigeon reads the structure of your file and maps it to guide sections:

  • Markdown headings — lines starting with # or ## become section titles
  • Body text — paragraphs below each heading become the section content
  • Plain text — if there are no headings, Pigeon will try to split by paragraph breaks or blank lines
For best results with plain text files, use a clear heading structure. A file with no headings will be imported as a single section.
04
Review and adjust
Clean up anything that didn't import as expected.

After import you'll land in the guide editor with your sections pre-populated. Review each one and make any adjustments — rename sections, trim content, split sections that are too long, or merge ones that are too short.

Screenshot: Imported guide in editor Drop image at /images/docs/md-imported.png