opened
pete88b
username_0
https://github.com/fastai/nbdev/pull/218 updated `show_doc` to not convert names in backticks to links - if the name is used as a parameter of the element passed to `show_doc`.

This means that you can backtick a module or function name in the doc string of a function and
- it will be formatted as code (not converted to a link)
- if the name is used as a parameter of the function.

I think it could be worth extending this behavior to the markdown following a show_doc call - as described [here](https://username_0.github.io/nbdev_demo/apple.html).
should nbdev convert parameter names to links in markdown?
issue
created
jph00
username_1
I think if this can be implemented without making the code too complex, it's a good idea.
comment
created
pete88b
username_0
Hi @username_1 

I've not yet found a clean way to keep track of the last element processed by `show_doc` - was hoping to do this without changes to `show_doc` but it looks like support for function interception is not ready for prime time yet (e.g. https://github.com/dlshriver/intercepts).
How about changing `_re_backticks` to ignore anything in triple backticks?
comment
created
jph00
username_1
You can already use `<code>` to explicitly avoid link creation - does that suffice?
comment
created
pete88b
username_0
Yes (o:
comment
created
jph00
username_1
So, shall we close this, since we don't really have a solution?
comment
created
pete88b
username_0
Makes sense to me
comment
closed
pete88b
username_0
issue