A problem to run mkdocs

[Mauro Baldi]

Hello,

   I am very fresh in the use of Markdown.
I have just installed Python on Windows with the help of chocolatety and pip and then I installed Mardwon as explained in the guide online through the command

pip install mkdocs

However, when I run a command like

mkdocs --version,

an error message tells me that the command "mkdocs" is not recognized, while the installation correctly took place.
Can anybody help me, please?

[Waylan Limberg]

Mauro,

This is a known problem with Python on Windows. An update to the docs is coming which will clear this up a bit. Basically you need to add the "Scripts" directory to your PATH environment variable. If you are uncomfortable editing environment variables, you can use `python -m mkdocs` as the command.

Waylan

[Waylan Limberg]

I just spent some more time improving the docs. You can preview the updates here:

https://raw.githubusercontent.com/mkdocs/mkdocs/master/docs/index.md

Hope that helps.

Waylan

[harmony...@gmail.com]

Hi Waylan,

I am running Python/MKDocs on Windows and so far so good by following your excellent instructions..  I have created the my-project folder and it has the 3 list files inside, docs (w. Index.md), python and mkdocs.yml, but I cannot run the server command - see below - that launches the internal server. It keeps giving me error messages. I have tried everything.

```bash
$ mkdocs serve
INFO    -  Building documentation...
INFO    -  Cleaning site directory
[I 160402 15:50:43 server:271] Serving on http://127.0.0.1:8000
[I 160402 15:50:43 handlers:58] Start watching changes
[I 160402 15:50:43 handlers:60] Start detecting changes
```

So am stuck. Files are in this directory C:\Users\xxxxxx\my-project

Thanks for any help, -Harmony-dweller

[harmony...@gmail.com]

[Waylan Limberg]

I don't see any "error message" there. Based on that output everything is working as it should. Have you opened your browser and tried to visit http://127.0.0.1:8000?

[harmony...@gmail.com]

When I try to run serve cmd 

C:\Users\xxxxxxx\my-project>serve

 I get this error msg:

'serve' is not recognized as an internal or external command,
operable program or batch file.

Same thing happens with

C:\Users\xxxxxxx\my-project>python -m serve
'python' is not recognized as an internal or external command,
operable program or batch file.

I am in the right folder.  Any idea what's wrong?

[Waylan Limberg]

The command is `mkdocs serve` not just `serve`.

Waylan