René's URL Explorer Experiment


Title: Add native footnote authoring and lookup by pseudosavant · Pull Request #1616 · python-openxml/python-docx · GitHub

Open Graph Title: Add native footnote authoring and lookup by pseudosavant · Pull Request #1616 · python-openxml/python-docx

X Title: Add native footnote authoring and lookup by pseudosavant · Pull Request #1616 · python-openxml/python-docx

Description: Add native footnote creation and lookup, with precise reference placement and editable note content. Document.add_footnote(after=run, text=...) inserts a separate reference run without changing adjacent text or formatting. Document.footnotes exposes ordinary notes, and Run.footnote_ids exposes existing reference IDs. Notes support the existing block-container and run APIs. The implementation registers a typed footnotes story part, creates separator entries, reserves existing IDs, preserves note styles and numbering settings, and validates body or table-cell reference locations before adding package structures. It does not add endnotes, field-based reuse, note deletion, or pagination controls. Related to #1 and the broader proposal in #1392. This draft offers a narrower creation and lookup API for discussion. It is based directly on upstream master and contains no fork packaging or other feature commits. Validation: 1,628 upstream unit tests passed. 651 acceptance scenarios passed. New-module type checks and lint passed. Word-authored fixture round trips passed. Microsoft Word opened a generated note and confirmed reference placement and multi-paragraph content.

Open Graph Description: Add native footnote creation and lookup, with precise reference placement and editable note content. Document.add_footnote(after=run, text=...) inserts a separate reference run without changing adj...

X Description: Add native footnote creation and lookup, with precise reference placement and editable note content. Document.add_footnote(after=run, text=...) inserts a separate reference run without changing adj...

Opengraph URL: https://github.com/python-openxml/python-docx/pull/1616

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:199fd0e7-5527-dac1-d3a9-142e0c7110e6
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-id9D22:30B698:861BD:B8585:6AFF6C05
html-safe-nonceb15579d5afc6205c6c7ed000349c00908e751728631bb22374978e18dc93fc81
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5RDIyOjMwQjY5ODo4NjFCRDpCODU4NTo2QUZGNkMwNSIsInZpc2l0b3JfaWQiOiI0NjY2MTQ5NDc4MzAwODcxNjg1IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmac7fa1b303902af856c4a4736be182988ea06a2770f087331ccb58dfb2a80a0349
hovercard-subject-tagpull_request:4630207257
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/python-openxml/python-docx/pull/1616/files
twitter:imagehttps://avatars.githubusercontent.com/u/455424?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/455424?s=400&v=4
og:image:altAdd native footnote creation and lookup, with precise reference placement and editable note content. Document.add_footnote(after=run, text=...) inserts a separate reference run without changing adj...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None6d580fc7098c193d7866bf290c4c2b4859a153e87379f44161f35a4495e6b730
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/python-openxml/python-docx git https://github.com/python-openxml/python-docx.git
octolytics-dimension-user_id3403760
octolytics-dimension-user_loginpython-openxml
octolytics-dimension-repository_id13592924
octolytics-dimension-repository_nwopython-openxml/python-docx
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id13592924
octolytics-dimension-repository_network_root_nwopython-openxml/python-docx
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
releaseec5dd94a369dad6e9ce618a1705cbe3b618a2863
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/python-openxml/python-docx/pull/1616/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython-openxml%2Fpython-docx%2Fpull%2F1616%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython-openxml%2Fpython-docx%2Fpull%2F1616%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=python-openxml%2Fpython-docx
Reloadhttps://github.com/python-openxml/python-docx/pull/1616/files
Reloadhttps://github.com/python-openxml/python-docx/pull/1616/files
Reloadhttps://github.com/python-openxml/python-docx/pull/1616/files
python-openxmlhttps://github.com/python-openxml
python-docxhttps://github.com/python-openxml/python-docx
Codehttps://github.com/python-openxml/python-docx
Issues387 (387)https://github.com/python-openxml/python-docx/issues
Pull requests167 (167)https://github.com/python-openxml/python-docx/pulls
Actionshttps://github.com/python-openxml/python-docx/actions
Projectshttps://github.com/python-openxml/python-docx/projects
Wikihttps://github.com/python-openxml/python-docx/wiki
Security and qualityhttps://github.com/python-openxml/python-docx/security
Insightshttps://github.com/python-openxml/python-docx/insights
Sign up for GitHub https://github.com/signup?return_to=%2Fpython-openxml%2Fpython-docx%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fpython-openxml%2Fpython-docx%2Fissues%2Fnew%2Fchoose
pseudosavanthttps://github.com/pseudosavant
python-openxml:masterhttps://github.com/python-openxml/python-docx/tree/master
pseudosavant:codex/footnotes-upstreamhttps://github.com/pseudosavant/python-docx/tree/codex/footnotes-upstream
Conversation 0 https://github.com/python-openxml/python-docx/pull/1616
Commits 1 https://github.com/python-openxml/python-docx/pull/1616/commits
Checks 0 https://github.com/python-openxml/python-docx/pull/1616/checks
Files changed https://github.com/python-openxml/python-docx/pull/1616/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1616/files
Add native footnote authoring and lookup https://github.com/python-openxml/python-docx/pull/1616/files#top
Show all changes 1 commit https://github.com/python-openxml/python-docx/pull/1616/files
887eaf6 Add native footnote authoring and lookup pseudosavant Sep 24, 2026 https://github.com/python-openxml/python-docx/pull/1616/commits/887eaf6842b0f413c61525db49a8989056d76c67
Clear filters https://github.com/python-openxml/python-docx/pull/1616/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1616/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1616/files
footnotes.rst https://github.com/python-openxml/python-docx/pull/1616/files#diff-ad19f41024ba66ec4ffd4dc9aaa0ec896aebb28434d65c256433872e5474013a
index.rst https://github.com/python-openxml/python-docx/pull/1616/files#diff-8d068e8797e88947c320f79e856c3e16a72b730124a8f9d7031e2c4680dfa534
footnotes.rst https://github.com/python-openxml/python-docx/pull/1616/files#diff-bddf358906537804f207cd69a1aeb3408d0a31824f7eaccf45496ca01beaaa96
doc-footnotes.feature https://github.com/python-openxml/python-docx/pull/1616/files#diff-3ea5f7366e1e699367ca8a64776d452f552ae8bc8c706e0e614d1313205cff0f
footnotes.py https://github.com/python-openxml/python-docx/pull/1616/files#diff-ba547b3e22815c571e7f9d776f5338fa5ea0495c3e574b1cae61c3fd1cc4e3c3
__init__.py https://github.com/python-openxml/python-docx/pull/1616/files#diff-c0bf42026978200784773e804db3ffff39372f9455f2152da258374d3d10d136
blkcntnr.py https://github.com/python-openxml/python-docx/pull/1616/files#diff-c3412b563d2f34a04006ee2658cf010fc11364d4c792f0b2b240a687dd3ce605
document.py https://github.com/python-openxml/python-docx/pull/1616/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
footnotes.py https://github.com/python-openxml/python-docx/pull/1616/files#diff-ced1af0fc226de1b3511ba98183e22d6f4c762cf4c0d51dbfdb740d0a72a472c
__init__.py https://github.com/python-openxml/python-docx/pull/1616/files#diff-4b1c4dcf03dbdf6a05c491cae8d35f84d025d0bf7669079faaca026b5a9409ef
footnotes.py https://github.com/python-openxml/python-docx/pull/1616/files#diff-f430725fa58b4c393dde97e3007b90cb5fcc47f7f762129d68d34102a1386113
settings.py https://github.com/python-openxml/python-docx/pull/1616/files#diff-19835c1e0c13c9be55a81d31c74a7f8af1667d132cc8a3e40bc3c49d763757ee
footnotes.py https://github.com/python-openxml/python-docx/pull/1616/files#diff-fd6ab75474a3618a25d84ff7d8eea865622604e6aa99521d99986b1a93a238d0
run.py https://github.com/python-openxml/python-docx/pull/1616/files#diff-93a63e78713879c0fd787128dfc3a563806eff684b68e9ba3a3fd0cd11e47e45
footnotes-word.docx https://github.com/python-openxml/python-docx/pull/1616/files#diff-1326d9f39b83704b9cfcdadce4e291366e508e82b0d597fa627d1b2d20117da8
footnotes-word.rst https://github.com/python-openxml/python-docx/pull/1616/files#diff-94430fa1413b76227d7ab8e8146b61e804c756c65b65e0a3092a3da2e243a44b
test_footnotes.py https://github.com/python-openxml/python-docx/pull/1616/files#diff-e1e03a962cfd3321b6ae7946137a7c00bce6ab7434738c65c84d20bd96c3dfaa
docs/api/footnotes.rsthttps://github.com/python-openxml/python-docx/pull/1616/files#diff-ad19f41024ba66ec4ffd4dc9aaa0ec896aebb28434d65c256433872e5474013a
View file https://github.com/python-openxml/python-docx/blob/887eaf6842b0f413c61525db49a8989056d76c67/docs/api/footnotes.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1616/{{ revealButtonHref }}
docs/index.rsthttps://github.com/python-openxml/python-docx/pull/1616/files#diff-8d068e8797e88947c320f79e856c3e16a72b730124a8f9d7031e2c4680dfa534
View file https://github.com/python-openxml/python-docx/blob/887eaf6842b0f413c61525db49a8989056d76c67/docs/index.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1616/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1616/files#diff-8d068e8797e88947c320f79e856c3e16a72b730124a8f9d7031e2c4680dfa534
https://github.com/python-openxml/python-docx/pull/1616/files#diff-8d068e8797e88947c320f79e856c3e16a72b730124a8f9d7031e2c4680dfa534
https://github.com/python-openxml/python-docx/pull/1616/files#diff-8d068e8797e88947c320f79e856c3e16a72b730124a8f9d7031e2c4680dfa534
docs/user/footnotes.rsthttps://github.com/python-openxml/python-docx/pull/1616/files#diff-bddf358906537804f207cd69a1aeb3408d0a31824f7eaccf45496ca01beaaa96
View file https://github.com/python-openxml/python-docx/blob/887eaf6842b0f413c61525db49a8989056d76c67/docs/user/footnotes.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1616/{{ revealButtonHref }}
features/doc-footnotes.featurehttps://github.com/python-openxml/python-docx/pull/1616/files#diff-3ea5f7366e1e699367ca8a64776d452f552ae8bc8c706e0e614d1313205cff0f
View file https://github.com/python-openxml/python-docx/blob/887eaf6842b0f413c61525db49a8989056d76c67/features/doc-footnotes.feature
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1616/{{ revealButtonHref }}
features/steps/footnotes.pyhttps://github.com/python-openxml/python-docx/pull/1616/files#diff-ba547b3e22815c571e7f9d776f5338fa5ea0495c3e574b1cae61c3fd1cc4e3c3
View file https://github.com/python-openxml/python-docx/blob/887eaf6842b0f413c61525db49a8989056d76c67/features/steps/footnotes.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1616/{{ revealButtonHref }}
src/docx/__init__.pyhttps://github.com/python-openxml/python-docx/pull/1616/files#diff-c0bf42026978200784773e804db3ffff39372f9455f2152da258374d3d10d136
View file https://github.com/python-openxml/python-docx/blob/887eaf6842b0f413c61525db49a8989056d76c67/src/docx/__init__.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1616/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1616/files#diff-c0bf42026978200784773e804db3ffff39372f9455f2152da258374d3d10d136
https://github.com/python-openxml/python-docx/pull/1616/files#diff-c0bf42026978200784773e804db3ffff39372f9455f2152da258374d3d10d136
https://github.com/python-openxml/python-docx/pull/1616/files#diff-c0bf42026978200784773e804db3ffff39372f9455f2152da258374d3d10d136
https://github.com/python-openxml/python-docx/pull/1616/files#diff-c0bf42026978200784773e804db3ffff39372f9455f2152da258374d3d10d136
src/docx/blkcntnr.pyhttps://github.com/python-openxml/python-docx/pull/1616/files#diff-c3412b563d2f34a04006ee2658cf010fc11364d4c792f0b2b240a687dd3ce605
View file https://github.com/python-openxml/python-docx/blob/887eaf6842b0f413c61525db49a8989056d76c67/src/docx/blkcntnr.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1616/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1616/files#diff-c3412b563d2f34a04006ee2658cf010fc11364d4c792f0b2b240a687dd3ce605
https://github.com/python-openxml/python-docx/pull/1616/files#diff-c3412b563d2f34a04006ee2658cf010fc11364d4c792f0b2b240a687dd3ce605
src/docx/document.pyhttps://github.com/python-openxml/python-docx/pull/1616/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
View file https://github.com/python-openxml/python-docx/blob/887eaf6842b0f413c61525db49a8989056d76c67/src/docx/document.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1616/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1616/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
https://github.com/python-openxml/python-docx/pull/1616/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
https://github.com/python-openxml/python-docx/pull/1616/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
https://github.com/python-openxml/python-docx/pull/1616/files#diff-8b5aed35cea2e719e419af099e5d7d2f6ff97b5737b5329dcf66c57031999541
src/docx/footnotes.pyhttps://github.com/python-openxml/python-docx/pull/1616/files#diff-ced1af0fc226de1b3511ba98183e22d6f4c762cf4c0d51dbfdb740d0a72a472c
View file https://github.com/python-openxml/python-docx/blob/887eaf6842b0f413c61525db49a8989056d76c67/src/docx/footnotes.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1616/{{ revealButtonHref }}
src/docx/oxml/__init__.pyhttps://github.com/python-openxml/python-docx/pull/1616/files#diff-4b1c4dcf03dbdf6a05c491cae8d35f84d025d0bf7669079faaca026b5a9409ef
View file https://github.com/python-openxml/python-docx/blob/887eaf6842b0f413c61525db49a8989056d76c67/src/docx/oxml/__init__.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1616/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1616/files#diff-4b1c4dcf03dbdf6a05c491cae8d35f84d025d0bf7669079faaca026b5a9409ef
https://github.com/python-openxml/python-docx/pull/1616/files#diff-4b1c4dcf03dbdf6a05c491cae8d35f84d025d0bf7669079faaca026b5a9409ef
https://github.com/python-openxml/python-docx/pull/1616/files#diff-4b1c4dcf03dbdf6a05c491cae8d35f84d025d0bf7669079faaca026b5a9409ef
https://github.com/python-openxml/python-docx/pull/1616/files#diff-4b1c4dcf03dbdf6a05c491cae8d35f84d025d0bf7669079faaca026b5a9409ef
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1616/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.