{"action":"created","issue":{"url":"https://api.github.com/repos/spatialaudio/nbsphinx/issues/36","repository_url":"https://api.github.com/repos/spatialaudio/nbsphinx","labels_url":"https://api.github.com/repos/spatialaudio/nbsphinx/issues/36/labels{/name}","comments_url":"https://api.github.com/repos/spatialaudio/nbsphinx/issues/36/comments","events_url":"https://api.github.com/repos/spatialaudio/nbsphinx/issues/36/events","html_url":"https://github.com/spatialaudio/nbsphinx/issues/36","id":146143692,"number":36,"title":"Allow conversion via markdown instead of RST","user":{"login":"bnaul","id":903655,"avatar_url":"https://avatars.githubusercontent.com/u/903655?v=3","gravatar_id":"","url":"https://api.github.com/users/bnaul","html_url":"https://github.com/bnaul","followers_url":"https://api.github.com/users/bnaul/followers","following_url":"https://api.github.com/users/bnaul/following{/other_user}","gists_url":"https://api.github.com/users/bnaul/gists{/gist_id}","starred_url":"https://api.github.com/users/bnaul/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bnaul/subscriptions","organizations_url":"https://api.github.com/users/bnaul/orgs","repos_url":"https://api.github.com/users/bnaul/repos","events_url":"https://api.github.com/users/bnaul/events{/privacy}","received_events_url":"https://api.github.com/users/bnaul/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2016-04-05T23:59:27Z","updated_at":"2016-04-06T00:30:28Z","closed_at":null,"body":"Currently there are some markdown formatting difficulties that can arise when converting to HTML. For example, a link like ``[`nbsphinx`](https://github.com/spatialaudio/nbsphinx)`` which should render as [`nbsphinx`](https://github.com/spatialaudio/nbsphinx) (cf. [nbsphinx](https://github.com/spatialaudio/nbsphinx)) won't be displayed properly because this text can't easily be represented in the intermediate RST.\r\n\r\nSince `sphinx` can easily produce documents directly from markdown (e.g. using `recommonmark`), it would be nice if it were possible to skip the RST altogether as this would more reliably reproduce the desired formatting from the notebook. Currently I am using `nbconvert` to get markdown output and then producing HTML with Sphinx instead of using `nbsphinx` because of such formatting issues.\r\n\r\ncc: @fperez @takluyver"},"comment":{"url":"https://api.github.com/repos/spatialaudio/nbsphinx/issues/comments/206047559","html_url":"https://github.com/spatialaudio/nbsphinx/issues/36#issuecomment-206047559","issue_url":"https://api.github.com/repos/spatialaudio/nbsphinx/issues/36","id":206047559,"user":{"login":"willingc","id":2680980,"avatar_url":"https://avatars.githubusercontent.com/u/2680980?v=3","gravatar_id":"","url":"https://api.github.com/users/willingc","html_url":"https://github.com/willingc","followers_url":"https://api.github.com/users/willingc/followers","following_url":"https://api.github.com/users/willingc/following{/other_user}","gists_url":"https://api.github.com/users/willingc/gists{/gist_id}","starred_url":"https://api.github.com/users/willingc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/willingc/subscriptions","organizations_url":"https://api.github.com/users/willingc/orgs","repos_url":"https://api.github.com/users/willingc/repos","events_url":"https://api.github.com/users/willingc/events{/privacy}","received_events_url":"https://api.github.com/users/willingc/received_events","type":"User","site_admin":false},"created_at":"2016-04-06T00:30:28Z","updated_at":"2016-04-06T00:30:28Z","body":"@bnaul Another thing to look at is the exact versions that you are using in Sphinx, nbsphinx, and recommonmark. Certain combinations have more issues than others."}}