replace old formatting syntax in shared_docs and Appender
- [X] sample of #30933
- [X] tests added / passed
- [X] passes `black pandas`
- [X] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry
