Skip to content

docs(notebooks): Document markdown paste auto-rendering#16925

Open
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-05-20T09-52-03-805Z-97y7or
Open

docs(notebooks): Document markdown paste auto-rendering#16925
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-05-20T09-52-03-805Z-97y7or

Conversation

@inkeep
Copy link
Copy Markdown
Contributor

@inkeep inkeep Bot commented May 20, 2026

Changes

This PR updates the notebooks documentation to inform users about the new markdown paste feature introduced in PostHog/posthog#59142.

Updates made:

  1. Updated "Adding content to notebooks" section to mention four methods instead of three
  2. Added a 4th method describing markdown paste functionality
  3. Added a note in the "Text" section explaining that pasted markdown is auto-rendered

What the feature does:

  • When users paste raw markdown text (without HTML), notebooks automatically detect and render it as formatted content
  • Detection covers block-level markdown: headings (##), lists (-, *, 1.), blockquotes (>), fenced code blocks, horizontal rules, and tables
  • Inline-only markdown (**bold**, _italic_) is intentionally NOT auto-detected to avoid surprising users when pasting prose

This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

Closes PostHog/posthog#59142

@inkeep inkeep Bot requested a review from willwearing May 20, 2026 09:53
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 20, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview May 20, 2026 10:07AM

@github-actions
Copy link
Copy Markdown
Contributor

Vale prose linter → found 1 errors, 38 warnings, 0 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/notebooks/index.mdx — 1 errors, 38 warnings, 0 suggestions
Line Severity Message Rule
14:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
16:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
18:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
20:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
22:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
24:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
26:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
28:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
30:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
32:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
34:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
36:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
38:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
40:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
42:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
44:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
46:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
48:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
50:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
52:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
54:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
56:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
104:14 warning Use 'Markdown' instead of 'markdown'. Vale.Terms
104:35 warning Use 'Markdown' instead of 'markdown'. Vale.Terms
104:98 warning Use 'Markdown' instead of 'markdown'. Vale.Terms
104:129 warning 'blockquotes' is a possible misspelling. PostHogBase.Spelling
104:291 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
122:20 warning Use 'Markdown' instead of 'markdown'. Vale.Terms
122:156 warning 'blockquotes' is a possible misspelling. PostHogBase.Spelling
122:198 warning Use 'Markdown' instead of 'markdown'. Vale.Terms
148:166 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
157:62 warning Use bold (text) for UI elements, not quotes. PostHogDocs.UIBoldNotQuotes
157:155 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
157:205 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
166:5 warning 'Feature flags' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
166:5 warning Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept. PostHogBase.ProductNames
170:166 warning Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept. PostHogBase.ProductNames
214:93 warning Avoid trivializing words. 'easily' can sound dismissive to the reader. PostHogDocs.Trivializers
214:128 warning Use American English. Use 'organization' instead of 'organisation'. PostHogBase.AmericanEnglish

@github-actions
Copy link
Copy Markdown
Contributor

Hey @willwearing! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.

  1. Review and approve the PR
  2. Merge the PR
    a. Check the preview env and CI build and merge it yourself
    b. Enable auto-merge if you're confident in the changes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants